Command Reference

In this subsection all commands are collected:

Accounting

dirac-accounting-decode-fileid

Decode Accounting plot URLs

Usage:

dirac-accounting-decode-fileid [options] ... URL [URL]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

URL:  encoded URL of a DIRAC Accounting plot

dirac-admin-accounting-cli

Command line administrative interface to DIRAC Accounting DataStore Service

Usage:

dirac-admin-accounting-cli [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Configuration

dirac-admin-add-resources

Add resources from the BDII database for a given VO

Usage:

dirac-admin-add-resources [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-V  --vo <value>             : Virtual Organization
-D  --dry                    : Dry run
-C  --ce                     : Process Computing Elements
-H  --host <value>           : use this url for information querying
    --onecore                : Add Single Core Queues for each MultiCore Queue, set RequiredTag for those Queues

dirac-admin-add-shifter

Adds or modify a shifter, in the operations section of the CS

Usage:

dirac-admin-add-shifter [options] ... ShifterRole UserName DIRACGroup

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

ShifterRole:  Name of the shifter role, e.g. DataManager
UserName:     A user name, as registered in Registry section
DIRACGroup:   DIRAC Group, e.g. diracAdmin (the user has to have this role)

dirac-admin-add-site

Add a new DIRAC SiteName to DIRAC Configuration, including one or more CEs. If site is already in the CS with another name, error message will be produced. If site is already in the CS with the right name, only new CEs will be added.

Usage:

dirac-admin-add-site [options] ... DIRACSiteName GridSiteName CE [CE]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

DIRACSiteName:  Name of the site for DIRAC in the form GRID.LOCATION.COUNTRY (ie: LCG.CERN.ch)
GridSiteName:   Name of the site in the Grid (ie: CERN-PROD)
CE:             Name of the CE to be included in the site (ie: ce111.cern.ch)

Example:

$ dirac-admin-add-site LCG.IN2P3.fr IN2P3-Site ce01.in2p3.fr

dirac-admin-check-config-options

Check configuration options against the defaults in the ConfigTemplate.cfg files.

This script can help to discover discrepancies in the configuration:

- Typos in option names
- Removed options
- Missing authorization settings

This script should be run by dirac administrators after major updates.

Usage:

dirac-admin-check-config-options [options] -[MAUO] [-S <system>]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-S  --system <value>         : Systems to check, by default all of them are checked
-M  --modified               : Show entries which differ from the default
-A  --added                  : Show entries which do not exist in ConfigTemplate
-U  --missingSection         : Show sections which do not exist in the current configuration
-O  --missingOption          : Show options which do not exist in the current configuration

dirac-admin-sort-cs-sites

Sort site names at CS in “/Resources” section. Sort can be alphabetic or by country postfix in a site name. Alphabetic sort is default (i.e. LCG.IHEP.cn, LCG.IHEP.su, LCG.IN2P3.fr)

Usage:

dirac-admin-sort-cs-sites [options] ... Section [Section]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-C  --country                : Sort site names by country postfix (i.e. LCG.IHEP.cn, LCG.IN2P3.fr, LCG.IHEP.su)
-R  --reverse                : Reverse the sort order

Arguments:

Section:  Name of the subsection in '/Resources/Sites/' for sort (i.e. LCG DIRAC) (optional)

Example:

$ dirac-admin-sort-cs-sites -C CLOUDS DIRAC
sort site names by country postfix in '/Resources/Sites/CLOUDS' and '/Resources/Sites/DIRAC' subsection

dirac-admin-voms-sync

Synchronize VOMS user data with the DIRAC Registry

Usage:

dirac-admin-voms-sync [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-V  --vo <value>             : VO name
-D  --dryRun                 : Dry run

dirac-configuration-cli

Command line interface to DIRAC Configuration Server

Usage:

dirac-configuration-cli [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-configuration-dump-local-cache

Dump DIRAC Configuration data

Usage:

dirac-configuration-dump-local-cache [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --file <value>           : Dump Configuration data into <file>
-r  --raw                    : Do not make any modification to the data

dirac-configuration-shell

Script that emulates the behaviour of a shell to edit the CS config.

Usage:

dirac-configuration-shell [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Core

dirac-agent

This is a script to launch DIRAC agents. Mostly internal.

Usage:

dirac-agent [options] ... Agent [Agent]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Agent:  specify which agent to run

dirac-cert-convert

Script converts the user certificate in the p12 format into a standard .globus usercert.pem and userkey.pem files. Creates the necessary directory, $HOME/.globus, if needed. Backs-up old pem files if any are found.

Usage:

dirac-cert-convert [options] ... P12

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

P12:  user certificate in the p12

dirac-configure

Main script to write dirac.cfg for a new DIRAC installation and initial download of CAs and CRLs

if necessary.

To be used by VO specific scripts to configure new DIRAC installations.

Additionally all options can all be passed inside a .cfg file, see the –cfg option.

The following options are recognized:

Setup
ConfigurationServer
IncludeAllServers
Gateway
SiteName
CEName
VirtualOrganization
UseServerCertificate
SkipCAChecks
SkipCADownload
Architecture
LocalSE
LogLevel

Setup and ConfigurationServer(Gateway) is mandatory options.

As in any other script command line option take precedence over .cfg files passed as arguments. The combination of both is written into the installed dirac.cfg.

Notice: It will not overwrite exiting info in current dirac.cfg if it exists.

Example:

$ dirac-configure -d
                  -S LHCb-Development
                  -C 'dips://lhcbprod.pic.es:9135/Configuration/Server'
                  -W 'dips://lhcbprod.pic.es:9135'
                  --SkipCAChecks

Usage:

dirac-configure [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

    --login=                 : Set DIRAC authorization endpoint
-S  --Setup <value>          : Set <setup> as DIRAC setup
-e  --Extensions <value>     : Set <extensions> as DIRAC extensions
-C  --ConfigurationServer <value>  : Set <server> as DIRAC configuration server
-I  --IncludeAllServers      : include all Configuration Servers
-n  --SiteName <value>       : Set <sitename> as DIRAC Site Name
-N  --CEName <value>         : Determiner <sitename> from <cename>
-V  --VO <value>             : Set the VO name
-W  --gateway <value>        : Configure <gateway> as DIRAC Gateway for the site
-U  --UseServerCertificate   : Configure to use Server Certificate
-H  --SkipCAChecks           : Configure to skip check of CAs
-D  --SkipCADownload         : Configure to skip download of CAs
-M  --SkipVOMSDownload       : Configure to skip download of VOMS info
-A  --Architecture <value>   : Configure /Architecture=<architecture>
-L  --LocalSE <value>        : Configure LocalSite/LocalSE=<localse>
-F  --ForceUpdate            : Force Update of cfg file (i.e. dirac.cfg) (otherwise nothing happens if dirac.cfg already exists)
-O  --output <value>         : output configuration file

Example:

$ dirac-configure -d
                  -S LHCb-Development
                  -C 'dips://lhcbprod.pic.es:9135/Configuration/Server'
                  -W 'dips://lhcbprod.pic.es:9135'
                  --SkipCAChecks

dirac-executor

This is a script to launch DIRAC executors

Usage:

dirac-executor [options] ... executor [executor]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

executor:  specify which executor to run

dirac-generate-cas

Generate a single CA file with all the PEMs

Usage:

dirac-generate-cas [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-generate-crls

Generate a single CRLs file

Usage:

dirac-generate-crls [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-info

Report info about local DIRAC installation

Usage:

dirac-info [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-v  --version                : print version of current DIRAC installation
-p  --platform               : print platform of current DIRAC installation

Example:

$ dirac-info


Option                 Value
============================
Setup                  Dirac-Production
ConfigurationServer    dips://ccdiracli08.in2p3.fr:9135/Configuration/Server
Installation path      /opt/dirac/versions/v7r2-pre33_1613239204
Installation type      client
Platform               Linux_x86_64_glibc-2.17
VirtualOrganization    dteam
User DN                /DC=org/DC=ugrid/O=people/O=BITP/CN=Andrii Lytovchenko
Proxy validity, secs   0
Use Server Certificate Yes
Skip CA Checks         No
DIRAC version          v7r2-pre33

dirac-install-db

Create a new DB in the MySQL server

Usage:

dirac-install-db [options] ... DB [DB]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

DB:  Name of the Database

dirac-install-web-portal

Do the initial installation of a DIRAC Web portal

Usage:

dirac-install-web-portal [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-platform

Linux_x86_64_glibc-2.30

dirac-service

This is a script to launch DIRAC services. Mostly internal.

Usage:

dirac-service [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-setup-site

Initial installation and configuration of a new DIRAC server (DBs, Services, Agents, Web Portal,…)

Usage:

dirac-setup-site [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-e  --exitOnError            : flag to exit on error of any component installation

dirac-version

usage: dirac_version.py [-h]

Print version of current DIRAC installation

Usage:

dirac-version [option]

Example:

$ dirac-version

optional arguments:

-h, --help  show this help message and exit

DataManagement

dirac-admin-allow-se

Enable using one or more Storage Elements

Usage:

dirac-admin-allow-se [options] ... seGroupList [seGroupList]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-r  --AllowRead              :      Allow only reading from the storage element
-w  --AllowWrite             :      Allow only writing to the storage element
-k  --AllowCheck             :      Allow only check access to the storage element
-v  --AllowRemove            :     Allow only remove access to the storage element
-a  --All                    :     Allow all access to the storage element
-m  --Mute                   :      Do not send email
-S  --Site <value>           :      Allow all SEs associated to site

Arguments:

seGroupList:  list of SEs or comma-separated SEs

Example:

$ dirac-admin-allow-se M3PEC-disk

dirac-admin-ban-se

Ban one or more Storage Elements for usage

Usage:

dirac-admin-ban-se [options] ... seGroupList [seGroupList]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-r  --BanRead                :      Ban only reading from the storage element
-w  --BanWrite               :      Ban writing to the storage element
-k  --BanCheck               :      Ban check access to the storage element
-v  --BanRemove              :     Ban remove access to the storage element
-a  --All                    :     Ban all access to the storage element
-m  --Mute                   :      Do not send email
-S  --Site <value>           :      Ban all SEs associate to site (note that if writing is allowed, check is always allowed)

Arguments:

seGroupList:  list of SEs or comma-separated SEs

Example:

$ dirac-admin-ban-se M3PEC-disk

dirac-admin-user-quota

Show storage quotas for specified users or for all registered users if nobody is specified

Usage:

dirac-admin-user-quota [options] ... User [User]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

User:  list of SEs or comma-separated SEs (optional)

Example:

$ dirac-admin-user-quota
------------------------------
Username       |     Quota (GB)
------------------------------
atsareg        |           None
msapunov       |           None
vhamar         |           None
------------------------------

dirac-dms-add-file

Upload a file to the grid storage and register it in the File Catalog

Usage:

dirac-dms-add-file [options] ... LFN Path SE [GUID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --force                  : Force overwrite of existing file

Arguments:

LFN:      Logical File Name
Path:     Local path to the file
SE:       DIRAC Storage Element
GUID:     GUID to use in the registration (optional)

OR

Example:

$ dirac-dms-add-file LFN:/formation/user/v/vhamar/Example.txt Example.txt DIRAC-USER
{'Failed': {},
 'Successful': {'/formationes/user/v/vhamar/Example.txt': {'put': 0.70791220664978027,
                                                           'register': 0.61061787605285645}}}

dirac-dms-catalog-metadata

Get metadata for the given file specified by its Logical File Name or for a list of files contained in the specifed file

Usage:

dirac-dms-catalog-metadata [options] ... <LocalFile|LFN> Catalog [Catalog]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Names
Catalog:    file catalog plug-ins (optional)

Example:

$ dirac-dms-catalog-metadata /formation/user/v/vhamar/Example.txt
FileName                                     Size        GUID                                     Status   Checksum
/formation/user/v/vhamar/Example.txt         34          EDE6DDA4-3344-3F39-A993-8349BA41EB23     1        eed20d47

dirac-dms-change-replica-status

Change status of replica of a given file or a list of files at a given Storage Element

Usage:

dirac-dms-change-replica-status [options] ... <LocalFile|LFN> SE status

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Name
SE:         Storage Element
status:     status

dirac-dms-clean-directory

Clean the given directory or a list of directories by removing it and all the contained files and subdirectories from the physical storage and from the file catalogs.

Usage:

dirac-dms-clean-directory [options] ... <LocalFile|LFN>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Name

Example:

$ dirac-dms-clean-directory /formation/user/v/vhamar/newDir
Cleaning directory /formation/user/v/vhamar/newDir ...  OK

dirac-dms-create-archive-request

Create and put Requests to archive files.

List of operations

  1. Optionally replicate files to SourceSE

  2. ArchiveFiles: Create a tarball from input files, upload tarball to TarballSE

  3. ReplicateAndRegister Tarball to TargetSE

  4. Optionally: Add LFNs to an ArchiveSE

  5. Optionally: Check for Tarball Migration

  6. Remove all other replicas for these files, or remove all files

  7. Remove original replica of Tarball

Will copy all the respective files and place them in to tarballs. Then the tarballs are migrated to another storage element. Once the file is migrated to tape the original files will be removed. Optionally the original files can be registered in a special archive SE, so that their metadata is preserved.

Related Options

This script only works if the ArchiveFiles and CheckMigration RequestHandlers are configured. To prevent submission of broken requests the script needs to be enabled in the Operations section of the CS

  • Operations/DataManagement/ArchiveFiles/Enabled=True

Default values for any of the command line options can also be set in the CS

  • Operations/DataManagement/ArchiveFiles/ArchiveSE

  • Operations/DataManagement/ArchiveFiles/TarballSE

  • Operations/DataManagement/ArchiveFiles/SourceSE

  • Operations/DataManagement/ArchiveFiles/MaxFiles

Usage:

dirac-dms-create-archive-request [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-A  --ArchiveSE <value>      : SE for registering archive files at
-I  --TarballSE <value>      : SE to initially upload tarball
-P  --Path <value>           : LFN path to folder, all files in the folder will be archived
-N  --Name <value>           : Name of the Tarball, if not given: Path_Tars/Path_N.tar will be used to store tarballs
-L  --List <value>           : File containing list of LFNs to archive, requires Name to be given
    --MaxFiles=              : Maximum number to put in one tarball: Default 2000
    --MaxSize=               : Maximum number of Bytes to put in one tarball: Default 2147483648
-S  --SourceSE <value>       : Where to remove the LFNs from
-T  --TargetSE <value>       : Where to move the Tarball to
-M  --ReplicateTarball       : Replicate the tarball
-C  --CheckMigration         : Ensure the tarball is migrated to tape before removing any files or replicas
-D  --RemoveReplicas         : Remove Replicas from non-ArchiveSE
-U  --RemoveFiles            : Remove Archived files completely
-R  --RegisterDescendent     : Register the Tarball as a descendent of the archived LFNs
    --AllowReplication       : Enable first replicating to Source-SE
    --SourceOnly             : Only treat files that are already at the Source-SE
-X  --Execute                : Put Requests, else dryrun

dirac-dms-create-moving-request

Create and put Requests to move files.

List of operations:

#. ReplicateAndRegister LFNs
#. Check for Migration
#. Remove all other replicas for these files

Usage:

dirac-dms-create-moving-request [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-L  --List <value>           : File containing list of LFNs to move
-P  --Path <value>           : LFN path to folder, all files in the folder will be moved
-S  --SourceSE <value>       : Where to remove the LFNs from
-T  --TargetSE <value>       : Where to move the LFNs to
-N  --Name <value>           : Name of the Request
-C  --CheckMigration         : Ensure the LFNs are migrated to tape before removing any replicas
-X  --Execute                : Put Requests, else dryrun

dirac-dms-create-removal-request

Create a DIRAC RemoveReplica|RemoveFile request to be executed by the RMS

Usage:

dirac-dms-create-removal-request [options] ... SE LFN [LFN]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

SE:   StorageElement|All
LFN:  LFN or file containing a List of LFNs

dirac-dms-data-size

Get the size of the given file or a list of files

Usage:

dirac-dms-data-size [options] ... <LocalFile|LFN> LFN [LFN]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-u  --Unit <value>           :    Unit to use [default GB] (MB,GB,TB,PB)

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Name
LFN:        Logical File Name (optional)

Example:

$ dirac-dms-data-size  /formation/user/v/vhamar/Example.txt
------------------------------
Files          |      Size (GB)
------------------------------
1              |            0.0
------------------------------

dirac-dms-directory-sync

Provides basic rsync functionality for DIRAC

Syncs the source destination folder recursivly into the target destination

If option –sync is used contend that is not in the source directory but is only in the target directory will be deleted.

Usage:

dirac-dms-directory-sync [options] ... <LFN|Path> <Path|LFN> SE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --sync                   : Make target directory identical to source
-j  --parallel <value>       : Multithreaded download and upload

Arguments:

LFN:   Logical File Name (Path to directory)
Path:  Local path to the file (Path to directory)
SE:    DIRAC Storage Element (optional)

Example:

e.g.: Download
  dirac-dms-directory-sync LFN Path
or Upload
  dirac-dms-directory-sync Path LFN SE

dirac-dms-filecatalog-cli

Launch the File Catalog shell

Usage:

dirac-dms-filecatalog-cli [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --file-catalog <value>   :    Catalog client type to use (default FileCatalog)

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

dirac-dms-find-lfns

Find files in the FileCatalog using file metadata

Examples:

$ dirac-dms-find-lfns Path=/lhcb/user "Size>1000" "CreationDate<2015-05-15"

Usage:

dirac-dms-find-lfns [options] ... metaspec [metaspec]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Path=                  :     Path to search for
--SE=                    :     (comma-separated list of) SEs/SE-groups to be searched

Arguments:

metaspec:  metadata index specification (of the form: "meta=value" or "meta<value", "meta!=value", etc.) (optional)

dirac-dms-move-replica-request

Create a DIRAC MoveReplica request to be executed by the RMS

Usage:

dirac-dms-move-replica-request [options] ... sourceSE LFN targetSE [targetSE]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

sourceSE:  source SE
LFN:       LFN or file containing a List of LFNs
targetSE:  target SEs

dirac-dms-protocol-matrix

Generate a matrix of:

* protocols used for interactive TPC
* protocols used for FTS transfers
* Intermediate hop for multihop transfer

The output is a CSV file containing a matrix source/destination.

By default, all the SEs are taken into account, but the matrix is factorized by using baseSEs. If you want the detail per se, use –Full

Suppose you have the following in your CS:

StorageElementBases{
  IN2P3-Disk
}
StorageElements{
  IN2P3-DST{
    BaseSE = IN2P3-Disk
  }
  IN2P3-User{
    BaseSE = IN2P3-Disk
  }
  AnotherDisk{
  }
}

You can have the following combinations:

DIRAC-PROD>dirac-dms-protocol-matrix
Using sources: IN2P3-Disk, AnotherDisk
Using target: IN2P3-Disk, AnotherDisk


DIRAC-PROD>dirac-dms-protocol-matrix --FromSE=IN2P3-User
Using sources: IN2P3-User
Using target: IN2P3-Disk, AnotherDisk


DIRAC-PROD>dirac-dms-protocol-matrix --FromSE=IN2P3-User --Bidirection
Using sources: IN2P3-User
Using target: IN2P3-User

Usage:

dirac-dms-protocol-matrix [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--FromSE=                : SE1[,SE2,...]
--TargetSE=              : SE1[,SE2,...]
--OutputFile=            : CSV output file (default /tmp/protocol-matrix.csv)
--Bidirection            : If FromSE or TargetSE are specified, make a square matrix
--FTS                    : Display the protocols sent to FTS
--TPC                    : Display the protocols tried for interactive TPC
--Multihop               : Display the intermediate hop
--Full                   : Do not factorize with base SE
--ExcludeSE=             : SEs to not take into account for the matrix

dirac-dms-put-and-register-request

Create and put ‘PutAndRegister’ request with a single local file

warning: make sure the file you want to put is accessible from DIRAC production hosts,

i.e. put file on network fs (AFS or NFS), otherwise operation will fail!!!

Usage:

dirac-dms-put-and-register-request [options] ... requestName LFN localFile targetSE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

requestName:  a request name
LFN:          logical file name
localFile:    local file you want to put
targetSE:     target SE

dirac-dms-remove-catalog-files

Remove the given file or a list of files from the File Catalog

Usage:

dirac-dms-remove-catalog-files [options] ... <LocalFile|LFN>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Names

Example:

$ dirac-dms-remove-catalog-files   /formation/user/v/vhamar/1/1134/StdOut
Successfully removed 1 catalog files.

dirac-dms-remove-catalog-replicas

Remove the given file replica or a list of file replicas from the File Catalog This script should be used with great care as it may leave dark data in the storage! Use dirac-dms-remove-replicas instead

Usage:

dirac-dms-remove-catalog-replicas [options] ... <LocalFile|LFN> SE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Names
SE:         Storage element

dirac-dms-remove-files

Remove the given file or a list of files from the File Catalog and from the storage

Usage:

dirac-dms-remove-files [options] ... <LocalFile|LFN> LFN [LFN]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Names
LFN:        Logical File Names (optional)

Example:

$ dirac-dms-remove-files /formation/user/v/vhamar/Test.txt

dirac-dms-remove-replicas

Remove the given file replica or a list of file replicas from the File Catalog and from the storage.

Usage:

dirac-dms-remove-replicas [options] ... <LocalFile|LFN> SE [SE]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Names
SE:         Storage element

Example:

$ dirac-dms-remove-replicas /formation/user/v/vhamar/Test.txt IBCP-disk
Successfully removed DIRAC-USER replica of /formation/user/v/vhamar/Test.txt

dirac-dms-replica-metadata

Get the given file replica metadata from the File Catalog

Usage:

dirac-dms-replica-metadata [options] ... <LocalFile|LFN> SE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LocalFile:  Path to local file containing LFNs
LFN:        Logical File Names
SE:         Storage element

dirac-dms-replicate-and-register-request

Create and put ‘ReplicateAndRegister’ request.

Usage:

dirac-dms-replicate-and-register-request [options] ... requestName LFNs targetSE [targetSE]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-C  --Catalog <value>        : Catalog to use

Arguments:

requestName:  a request name
LFNs:         single LFN or file with LFNs
targetSE:     target SE

dirac-dms-resolve-guid

Returns the LFN matching given GUIDs

Usage:

dirac-dms-resolve-guid [options] ... GUIDs

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

GUIDs:  GUIDs separated by a comma

dirac-dms-set-replica-status

Set the status of the replicas of given files at the provided SE

Usage:

dirac-dms-set-replica-status [options] ... <LFN|File> SE Status

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LFN:     LFN
File:    File name containing a list of affected LFNs
SE:      Name of Storage Element
Status:  New Status for the replica

dirac-dms-show-se-status

Get status of the available Storage Elements

Usage:

dirac-dms-show-se-status [<options>]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-V  --vo <value>             : Virtual Organization
-a  --all                    : All Virtual Organizations flag
-n  --noVO                   : No Virtual Organizations assigned flag

Example:

$ dirac-dms-show-se-status
Storage Element               Read Status    Write Status
DIRAC-USER                         Active          Active
IN2P3-disk                         Active          Active
IPSL-IPGP-disk                     Active          Active
IRES-disk                        InActive        InActive
M3PEC-disk                         Active          Active
ProductionSandboxSE                Active          Active

dirac-dms-user-lfns

Get the list of all the user files.

Usage:

dirac-dms-user-lfns [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --Days <value>           : Match files older than number of days [0]
-M  --Months <value>         : Match files older than number of months [0]
-Y  --Years <value>          : Match files older than number of years [0]
-w  --Wildcard <value>       : Wildcard for matching filenames [All]
-b  --BaseDir <value>        : Base directory to begin search (default /[vo]/user/[initial]/[username])
-e  --EmptyDirs              : Create a list of empty directories

Example:

$ dirac-dms-user-lfns
/formation/user/v/vhamar: 14 files, 6 sub-directories
/formation/user/v/vhamar/newDir2: 0 files, 0 sub-directories
/formation/user/v/vhamar/testDir: 0 files, 0 sub-directories
/formation/user/v/vhamar/0: 0 files, 6 sub-directories
/formation/user/v/vhamar/test: 0 files, 0 sub-directories
/formation/user/v/vhamar/meta-test: 0 files, 0 sub-directories
/formation/user/v/vhamar/1: 0 files, 4 sub-directories
/formation/user/v/vhamar/0/994: 1 files, 0 sub-directories
/formation/user/v/vhamar/0/20: 1 files, 0 sub-directories
16 matched files have been put in formation-user-v-vhamar.lfns

dirac-dms-user-quota

Get the currently defined user data volume quotas

Usage:

dirac-dms-user-quota [options]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Example:

$ dirac-dms-user-quota
Current quota found to be 0.0 GB

Framework

dirac-admin-get-CAs

Refresh the local copy of the CA certificates and revocation lists.

Connects to the BundleDelivery service to obtain the tar balls. Needed when proxies appear to be invalid.

Usage:

dirac-admin-get-CAs [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Example:

$ dirac-admin-get-CAs

dirac-admin-get-proxy

Retrieve a delegated proxy for the given user and group

Usage:

dirac-admin-get-proxy [options] ... <DN|user> group

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-v  --valid <value>          : Valid HH:MM for the proxy. By default is 24 hours
-l  --limited                : Get a limited proxy
-u  --out <value>            : File to write as proxy
-a  --voms                   : Get proxy with VOMS extension mapped to the DIRAC group
-m  --vomsAttr <value>       : VOMS attribute to require

Arguments:

DN:     DN of the user
user:   DIRAC user name (will fail if there is more than 1 DN registered)
group:  DIRAC group name

Example:

$ dirac-admin-get-proxy vhamar dirac_user
Proxy downloaded to /afs/in2p3.fr/home/h/hamar/proxy.vhamar.dirac_user

dirac-admin-proxy-upload

Upload proxy.

Usage:

dirac-admin-proxy-upload [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-v  --valid <value>          : Valid HH:MM for the proxy. By default is one month
-C  --Cert <value>           : File to use as user certificate
-K  --Key <value>            : File to use as user key
-P  --Proxy <value>          : File to use as proxy
-f  --onthefly               : Generate a proxy on the fly
-p  --pwstdin                : Get passwd from stdin

Example:

$ dirac-admin-proxy-upload

dirac-admin-sysadmin-cli

System administrator client.

Usage:

dirac-admin-sysadmin-cli [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-H  --host <value>           :    Target host

Example:

$ dirac-admin-sysadmin-cli --host dirac.in2p3.fr
DIRAC Root Path = /afs/in2p3.fr/home/h/hamar/DIRAC-v5r12
dirac.in2p3.fr >

dirac-admin-update-instance

Script to apply update to all or some dirac servers and restart them

Usage:

dirac-admin-update-instance [options] ... version

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--hosts=                 : Comma separated list of hosts or file containing row wise list of hosts targeted for update (leave empty for all)
--excludeHosts=          : Comma separated list of hosts or file containing row wise list of hosts excluded from update
--retry=                 : Number of retry attempts on hosts that have failed to update

Arguments:

version:  version of DIRAC you want to update to

dirac-admin-update-pilot

Script to update pilot version in CS

Usage:

dirac-admin-update-pilot [options] ... version

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-v  --vo <value>             : Location of pilot version in CS /Operations/<vo>/Pilot/Version (default value specified in CS under /DIRAC/DefaultSetup)

Arguments:

version:  pilot version you want to update to

dirac-admin-users-with-proxy

Print list of users with proxies.

Usage:

dirac-admin-users-with-proxy [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-v  --valid <value>          : Required HH:MM for the users

Example:

$ dirac-admin-users-with-proxy
* vhamar
DN         : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
group      : dirac_admin
not after  : 2011-06-29 12:04:25
persistent : False
-
DN         : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
group      : dirac_pilot
not after  : 2011-06-29 12:04:27
persistent : False
-
DN         : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
group      : dirac_user
not after  : 2011-06-29 12:04:30
persistent : True

dirac-install-component

2023-02-02 15:21:33 UTC Framework ALWAYS: Can’t load /home/docs/checkouts/readthedocs.org/user_builds/dirac/conda/latest/etc/dirac.cfg 2023-02-02 15:21:33 UTC Framework ALWAYS: Might be OK if setting up the site

Do the initial installation and configuration of a DIRAC component

Usage:

dirac-install-component [options] ... <System/Component|System> Component

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-w  --overwrite              : Overwrite the configuration in the global CS
-m  --module <value>         : Python module name for the component code
-p  --parameter <value>      : Special component option

Arguments:

System/Component:  Full component name (ie: WorkloadManagement/Matcher)
System:            Name of the DIRAC system (ie: WorkloadManagement)
Component:         Name of the DIRAC service (ie: Matcher) (optional)

dirac-install-tornado-service

2023-02-02 15:21:33 UTC Framework ALWAYS: Can’t load /home/docs/checkouts/readthedocs.org/user_builds/dirac/conda/latest/etc/dirac.cfg 2023-02-02 15:21:33 UTC Framework ALWAYS: Might be OK if setting up the site

Do the initial installation and configuration of a DIRAC service based on tornado

Usage:

dirac-install-tornado-service [options] ... <System/Component|System> Component

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-w  --overwrite              : Overwrite the configuration in the global CS
-m  --module <value>         : Python module name for the component code
-p  --parameter <value>      : Special component option

Arguments:

System/Component:  Full component name (ie: WorkloadManagement/Matcher)
System:            Name of the DIRAC system (ie: WorkloadManagement)
Component:         Name of the DIRAC service (ie: Matcher) (optional)

dirac-login

With this command you can log in to DIRAC.

There are two options:

- using a user certificate, creating a proxy.
- go through DIRAC Authorization Server by selecting your Identity Provider.

Usage:

dirac-login [options] ... group scope [scope]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-T  --lifetime <value>       : set access lifetime in hours
-O  --out <value>            : where to save the authorization result(e.g: proxy or tokens). By default we will try to find a standard place.
-I  --issuer <value>         : set issuer.
    --use-certificate        : in case you want to generate a proxy using a certificate. By default.
    --use-diracas            : in case you want to authorize with DIRAC Authorization Server.
-C  --certificate <value>    : user certificate location
-K  --key <value>            : user key location
    --proxy                  : return proxy in case of successful authorization
    --token                  : return tokens in case of successful authorization
    --status                 : print user authorization status
    --nocs                   : disable CS.

Arguments:

group:  select a DIRAC group for authorization, can be determined later. (optional)
scope:  scope to add to authorization request. (optional)

Example:

# Login with default group
$ dirac-login
# Choose another group
$ dirac-login dirac_user
# Return token
$ dirac-login dirac_user --token

dirac-logout

Logout

Usage:

dirac-logout [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-I  --issuer <value>         : set issuer
-F  --file <value>           : set target file location

Example:

$ dirac-logout

dirac-myproxy-upload

Usage:

dirac-myproxy-upload [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --file <value>           : File to use as proxy
-D  --DN                     : Use DN as myproxy username

dirac-populate-component-db

Populates the database with the current installations of components This script assumes that the InstalledComponentsDB, the ComponentMonitoring service and the Notification service are installed and running

Usage:

dirac-populate-component-db [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-e  --exclude <value>        : Comma separated list of hosts to be excluded from the scanning process

dirac-proxy-destroy

Command line tool to remove local and remote proxies

Usage:

dirac-proxy-destroy [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-a  --all                    : Delete the local and all uploaded proxies (the nuclear option)
-v  --vo <value>             : Delete uploaded proxy for vo name given

Example:

$ dirac-proxy-destroy -a

dirac-proxy-get-uploaded-info

Print information about uploaded proxies.

Usage:

dirac-proxy-get-uploaded-info [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-u  --user <value>           : User to query (by default oneself)

Example:

$ dirac-proxy-get-uploaded-info
Checking for DNs /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
--------------------------------------------------------------------------------------------------------
| UserDN                                          | UserGroup   | ExpirationTime      | PersistentFlag |
--------------------------------------------------------------------------------------------------------
| /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar | dirac_user  | 2011-06-29 12:04:25 | True           |
--------------------------------------------------------------------------------------------------------

dirac-proxy-info

Print information about the current proxy.

Usage:

dirac-proxy-info [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --file <value>           : File to use as user key
-n  --novoms                 : Disable VOMS
-v  --checkvalid             : Return error if the proxy is invalid
-x  --nocs                   : Disable CS
-e  --steps                  : Show steps info
-m  --uploadedinfo           : Show uploaded proxies info

Example:

$ dirac-proxy-info
subject      : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar/CN=proxy/CN=proxy
issuer       : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar/CN=proxy
identity     : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
timeleft     : 23:53:55
DIRAC group  : dirac_user
path         : /tmp/x509up_u40885
username     : vhamar
VOMS         : True
VOMS fqan    : ['/formation']

dirac-proxy-init

Creating a proxy.

Usage:

dirac-proxy-init [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-v  --valid <value>          : Valid HH:MM for the proxy. By default is 24 hours
-g  --group <value>          : DIRAC Group to embed in the proxy
-b  --strength <value>       : Set the proxy strength in bytes
-l  --limited                : Generate a limited proxy
-t  --strict                 : Fail on each error. Treat warnings as errors.
-S  --summary                : Enable summary output when generating proxy
-C  --Cert <value>           : File to use as user certificate
-K  --Key <value>            : File to use as user key
-u  --out <value>            : File to write as proxy
-x  --nocs                   : Disable CS check
-p  --pwstdin                : Get passwd from stdin
-N  --no-upload              : Do not upload a long lived proxy to the ProxyManager
-M  --VOMS                   : Add voms extension

Example:

$ dirac-proxy-init -g dirac_user
Enter Certificate password: **************

dirac-restart-component

Restart DIRAC component using runsvctrl utility

Usage:

dirac-restart-component [options] ... System <Service|Agent>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

System:   Name of the system for the component (default *: all) [default: *] (optional)
Service:  Name of the particular component (default *: all) [default: *] (optional)
Agent:    Name of the particular component (default *: all) [default: *] (optional)

dirac-start-component

Start DIRAC component using runsvctrl utility

Usage:

dirac-start-component [options] ... System <Service|Agent>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

System:   Name of the system for the component (default *: all) [default: *] (optional)
Service:  Name of the particular component (default *: all) [default: *] (optional)
Agent:    Name of the particular component (default *: all) [default: *] (optional)

dirac-status-component

Status of DIRAC components using runsvstat utility

Usage:

dirac-status-component [options] ... System <Service|Agent>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

System:   Name of the system for the component (default *: all) [default: *] (optional)
Service:  Name of the particular component (default *: all) [default: *] (optional)
Agent:    Name of the particular component (default *: all) [default: *] (optional)

Example:

$ dirac-status-component
DIRAC Root Path = /vo/dirac/versions/Lyon-HEAD-1296215324
                                         Name : Runit    Uptime    PID
          WorkloadManagement_PilotStatusAgent : Run        4029     1697
           WorkloadManagement_JobHistoryAgent : Run        4029     167

dirac-stop-component

Stop DIRAC component using runsvctrl utility

Usage:

dirac-stop-component [options] ... System <Service|Agent>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

System:   Name of the system for the component (default *: all) [default: *] (optional)
Service:  Name of the particular component (default *: all) [default: *] (optional)
Agent:    Name of the particular component (default *: all) [default: *] (optional)

dirac-sys-sendmail

Utility to send an e-mail using DIRAC notification service.

Usage:

dirac-sys-sendmail [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Formated text message. The message consists of e-mail headers and e-mail body
separated by two newline characters. Headers are key : value pairs separated
by newline character. Meaningful headers are "To:", "From:", "Subject:".
Other keys will be ommited.
Message body is an arbitrary string.

Examples:

$ dirac-sys-sendmail "From: source@email.com\nTo: destination@email.com\nSubject: Test\n\nMessage body"
echo "From: source@email.com\nSubject: Test\n\nMessage body" | dirac-sys-sendmail destination@email.com

dirac-uninstall-component

2023-02-02 15:21:38 UTC Framework ALWAYS: Can’t load /home/docs/checkouts/readthedocs.org/user_builds/dirac/conda/latest/etc/dirac.cfg 2023-02-02 15:21:38 UTC Framework ALWAYS: Might be OK if setting up the site

Uninstallation of a DIRAC component

Usage:

dirac-uninstall-component [options] ... <System/Component|System> Component

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --force                  : Forces the removal of the logs

Arguments:

System/Component:  Full component name (ie: WorkloadManagement/Matcher)
System:            Name of the DIRAC system (ie: WorkloadManagement)
Component:         Name of the DIRAC service (ie: Matcher) (optional)

Interfaces

dcd

Change current DIRAC File Catalog working directory

Examples:

$ dcd /dirac/user
$ dcd

Usage:

dcd [options] ... Path

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Path:  path to new working directory (defaults to home directory) (optional)

dchgrp

Change file owner’s group in file catalog.

Examples:

$ dchgrp atsareg ././some_lfn_file
$ dchgrp -R pgay ./

Usage:

dchgrp [options] ... group Path [Path]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-R  --recursive              : recursive

Arguments:

group:  new group name
Path:   path to file

dchmod

Change file mode bits in the file catalog

Examples:

$ dchmod 755 ././some_lfn_file
$ dchmod -R 700 ./

Usage:

dchmod [options] ... mode Path [Path]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-R  --recursive              : recursive

Arguments:

mode:  octal mode bits
Path:  path to file

dchown

Change file owner

Examples:

$ dchown atsareg ././some_lfn_file
$ dchown -R pgay ./

Usage:

dchown [options] ... owner Path [Path]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-R  --recursive              : recursive

Arguments:

owner:  new owner name
Path:   path to file

dconfig

Configures ~/dirac/dcommands.conf. If run without arguments, lists contents of configuration file.

Examples:

$ dconfig -m (creates minimal config file in ~/dirac/dcommands.conf)
$ dconfig (lists contents of ~/dirac/dcommands.conf)

Usage:

dconfig [options] ... section[.option[=value]] [section[.option[=value]]]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-m  --minimal                : verify and fill minimal configuration

Arguments:

section[.option[=value]]:  section:              display all options in section
                        section.option:       display option
                        section.option=value: set option value (optional)

dfind

find files in the FileCatalog

Examples:

$ dfind . "some_integer_metadata>1"

Usage:

dfind [options] ... lfn metaspec [metaspec]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

lfn:       directory entry in the FileCatalog
metaspec:  metadata index specifcation (of the form: "meta=value" or "meta<value", "meta!=value", etc.) (optional)

dget

download files from storage element

Usage:

dget lfn... [local_dir]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-r  --recursive              : recursively get contents of lfn

Arguments:

lfn:          file to download
local_dir:   destination directory

Examples:

$ dget ./some_lfn_file /tmp

dgetenv

print DCommands session environment variables

Usage:

dgetenv [options] ... [section.]option

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

[section.]option:  section:              display all options in section
                section.option:       display section specific option (optional)

dinit

initialize DCommands/Shorthand Commands session

Usage:

dinit [options] ... profile name

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-p  --fromProxy              : build session from existing proxy
-D  --destroy                : destroy session information

Arguments:

profile name:  existing profile section in DCommands config (optional)

dirac-admin-add-group

Add or Modify a Group info in DIRAC

Usage:

dirac-admin-add-group [options] ... Property=<Value> [Property=<Value>]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-G  --GroupName <value>      : Name of the Group (Mandatory)
-U  --UserName <value>       : Short Name of user to be added to the Group (Allow Multiple instances or None)
-P  --Property <value>       : Property to be added to the Group (Allow Multiple instances or None)

Arguments:

Property=<Value>:  Other properties to be added to the Group like (VOMSRole=XXXX) (optional)

Example:

$ dirac-admin-add-group -G dirac_test

dirac-admin-add-host

Add or Modify a Host info in DIRAC

Usage:

dirac-admin-add-host [options] ... Property=<Value> [Property=<Value>]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-H  --HostName <value>       : Name of the Host (Mandatory)
-D  --HostDN <value>         : DN of the Host Certificate (Mandatory)
-P  --Property <value>       : Property to be added to the Host (Allow Multiple instances or None)

Arguments:

Property=<Value>:  Other properties to be added to the Host like (Responsible=XXX) (optional)

Example:

$ dirac-admin-add-host -H dirac.i2np3.fr -D /O=GRID-FR/C=FR/O=CNRS/OU=CC-IN2P3/CN=dirac.in2p3.fr

dirac-admin-add-user

Add or Modify a User info in DIRAC

Usage:

dirac-admin-add-user [options] ... Property=<Value> [Property=<Value>]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-N  --UserName <value>       : Short Name of the User (Mandatory)
-D  --UserDN <value>         : DN of the User Certificate (Mandatory)
-M  --UserMail <value>       : eMail of the user (Mandatory)
-G  --UserGroup <value>      : Name of the Group for the User (Allow Multiple instances or None)

Arguments:

Property=<Value>:  Properties to be added to the User like (Phone=XXXX) (optional)

Example:

$ dirac-admin-add-user -N vhamar -D /O=GRID/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar -M hamar@cppm.in2p3.fr -G dirac_user

dirac-admin-allow-site

Add Site to Active mask for current Setup

Usage:

dirac-admin-allow-site [options] ... Site Comment

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-E  --email <value>          : Boolean True/False (True by default)

Arguments:

Site:     Name of the Site
Comment:  Reason of the action

Example:

$ dirac-admin-allow-site LCG.IN2P3.fr "FRANCE"

dirac-admin-ban-site

Remove Site from Active mask for current Setup

Usage:

dirac-admin-ban-site [options] ... Site Comment

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-E  --email <value>          : Boolean True/False (True by default)

Arguments:

Site:     Name of the Site
Comment:  Reason of the action

Example:

$ dirac-admin-ban-site LCG.IN2P3.fr "Pilot installation problems"

dirac-admin-ce-info

Retrieve Site Associated to a given CE

Usage:

dirac-admin-ce-info [options] ... CE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

CE:  Name of the CE

Example:

$ dirac-admin-ce-info LCG.IN2P3.fr

dirac-admin-delete-user

Remove User from Configuration

Usage:

dirac-admin-delete-user [options] ... User [User]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

User:  User name

Example:

$ dirac-admin-delete-user vhamar

dirac-admin-get-banned-sites

Get banned sites

Usage:

dirac-admin-get-banned-sites [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Example:

$ dirac-admin-get-banned-sites
LCG.IN2P3.fr                      Site not present in logging table

dirac-admin-get-job-pilot-output

Retrieve the output of the pilot that executed a given job

Usage:

dirac-admin-get-job-pilot-output [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC ID of the Job

Example:

$ dirac-admin-get-job-pilot-output 34

dirac-admin-get-job-pilots

Retrieve info about pilots that have matched a given Job

Usage:

dirac-admin-get-job-pilots [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC ID of the Job

Example:

$ dirac-admin-get-job-pilots 1848
{'https://marlb.in2p3.fr:9000/bqYViq6KrVgGfr6wwgT45Q': {'AccountingSent': 'False',
                                                        'BenchMark': 8.1799999999999997,
                                                        'Broker': 'marwms.in2p3.fr',
                                                        'DestinationSite': 'lpsc-ce.in2p3.fr',
                                                        'GridSite': 'LCG.LPSC.fr',
                                                        'GridType': 'gLite',
                                                        'Jobs': [1848L],
                                                        'LastUpdateTime': datetime.datetime(2011, 2, 21, 12, 39, 10),
                                                        'OutputReady': 'True',
                                                        'OwnerDN': '/O=GRID/C=FR/O=CNRS/OU=LPC/CN=Sebastien Guizard',
                                                        'OwnerGroup': '/biomed',
                                                        'ParentID': 0L,
                                                        'PilotID': 2247L,
                                                        'PilotJobReference': 'https://marlb.in2p3.fr:9000/biq6KT45Q',
                                                        'PilotStamp': '',
                                                        'Status': 'Done',
                                                        'SubmissionTime': datetime.datetime(2011, 2, 21, 12, 27, 52),
                                                        'TaskQueueID': 399L}}

dirac-admin-get-pilot-info

Retrieve available info about the given pilot

Usage:

dirac-admin-get-pilot-info [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-e  --extended               : Get extended printout

Example:

$ dirac-admin-get-pilot-info https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw
{'https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw': {'AccountingSent': 'False',
                                                        'BenchMark': 0.0,
                                                        'Broker': 'marwms.in2p3.fr',
                                                        'DestinationSite': 'cclcgceli01.in2p3.fr',
                                                        'GridSite': 'LCG.IN2P3.fr',
                                                        'GridType': 'gLite',
                                                        'LastUpdateTime': datetime.datetime(2011, 2, 21, 12, 49, 14),
                                                        'OutputReady': 'False',
                                                        'OwnerDN': '/O=GRID/C=FR/O=CNRS/OU=LPC/CN=Sebastien Guizard',
                                                        'OwnerGroup': '/biomed',
                                                        'ParentID': 0L,
                                                        'PilotID': 2241L,
                                                        'PilotJobReference': 'https://marlb.in2p3.fr:9000/2KHFrQjkw',
                                                        'PilotStamp': '',
                                                        'Status': 'Done',
                                                        'SubmissionTime': datetime.datetime(2011, 2, 21, 12, 27, 52),
                                                        'TaskQueueID': 399L}}

dirac-admin-get-pilot-logging-info

Retrieve logging info of a Grid pilot

Usage:

dirac-admin-get-pilot-logging-info [options] ... PilotID [PilotID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

PilotID:  Grid ID of the pilot

Example:

$ dirac-admin-get-pilot-logging-info https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw
Pilot Reference: dirac-admin-get-pilot-logging-info https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw
===================== glite-job-logging-info Success =====================


LOGGING INFORMATION::

Printing info for the Job : https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw
    ---
Event: RegJob
- Arrived   =  Mon Feb 21 13:27:50 2011 CET
- Host      =  marwms.in2p3.fr
- Jobtype   =  SIMPLE
- Level     =  SYSTEM
- Ns        =  https://marwms.in2p3.fr:7443/glite_wms_wmproxy_server
- Nsubjobs  =  0
- Parent    =  https://marlb.in2p3.fr:9000/WQHVOB1mI4oqrlYz2ZKtgA
- Priority  =  asynchronous
- Seqcode   =  UI=000000:NS=0000000001:WM=000000:BH=0000000000:JSS=000000:LM=000000:LRMS=000000:APP=000000:LBS=000000
- Source    =  NetworkServer

dirac-admin-get-pilot-output

Retrieve output of a Grid pilot

Usage:

dirac-admin-get-pilot-output [options] ... PilotID [PilotID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

PilotID:  Grid ID of the pilot

Example:

$ dirac-admin-get-pilot-output https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw
$ ls -la
drwxr-xr-x  2 hamar marseill      2048 Feb 21 14:13 pilot_26KCLKBFtxXKHF4_ZrQjkw

dirac-admin-get-site-mask

Get the list of sites enabled in the mask for job submission

Usage:

dirac-admin-get-site-mask [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Example:

$ dirac-admin-get-site-mask
LCG.CGG.fr
LCG.CPPM.fr
LCG.LAPP.fr
LCG.LPSC.fr
LCG.M3PEC.fr
LCG.MSFG.fr

dirac-admin-list-hosts

List hosts

Usage:

dirac-admin-list-hosts [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-e  --extended               : Show extended info

Example:

$ dirac-admin-list-hosts
dirac.in2p3.fr
host-dirac.in2p3.fr

dirac-admin-list-users

Lists the users in the Configuration. If no group is specified return all users.

Usage:

dirac-admin-list-users [options] ... Group [Group]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-e  --extended               : Show extended info

Arguments:

Group:  Only users from this group (default: all) [default: ['all']] (optional)

Example:

$ dirac-admin-list-users


All users registered::

vhamar
msapunov
atsareg

dirac-admin-modify-user

Modify a user in the CS.

Usage:

dirac-admin-modify-user [options] ... user DN group [group]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-p  --property <value>       : Add property to the user <name>=<value>
-f  --force                  : create the user if it doesn't exist

Arguments:

user:   User name
DN:     DN of the User
group:  Add the user to the group

Example:

$ dirac-admin-modify-user vhamar /C=FR/O=Org/CN=User dirac_user

dirac-admin-pilot-summary

Pilot summary

Usage:

dirac-admin-pilot-summary [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Example:

$ dirac-admin-pilot-summary
CE                Status  Count Status Count Status Count Status  Count Status    Count Status    Count Status  Count
sbgce1.in2p3.fr   Done    31
lpsc-ce.in2p3.fr  Done    111
lyogrid2.in2p3.fr Done    81
egee-ce.jusieu.fr Aborted 81    Done   18
cclcgce3.in2p3.fr Done    275
marce01.in2p3.fr  Done    156
node7.datagrid.fr Done    75
cclcgceli01.fr    Aborted 1     Done   235
ce0.m3pec.u-bo.fr Done    63
grive11.ibcp.fr   Aborted 3     Done   90
lptace01.msfg.fr  Aborted 3     Done   3     Done   90
ipnls1.in2p3.fr   Done    87
Total             Aborted 89    Done   1423  Ready  0     Running 0     Scheduled 0     Submitted 0     Waiting 0
lappce01.in2p3.fr Aborted 1     Done   111

dirac-admin-reset-job

Reset a job or list of jobs in the WMS

Usage:

dirac-admin-reset-job [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job IDs

Example:

$ dirac-admin-reset-job 1848
Reset Job 1848

dirac-admin-service-ports

Print the service ports for the specified setup

Usage:

dirac-admin-service-ports [options] ... Setup

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Setup:  Name of the setup (optional)

Example:

$ dirac-admin-service-ports
{'Framework/ProxyManager': 9152,
 'Framework/SystemAdministrator': 9162,
 'Framework/UserProfileManager': 9155,
 'WorkloadManagement/JobManager': 9132,
 'WorkloadManagement/PilotManager': 9171,
 'WorkloadManagement/Matcher': 9170,
 'WorkloadManagement/SandboxStore': 9196,
 'WorkloadManagement/WMSAdministrator': 9145}

dirac-admin-set-site-protocols

Defined protocols for each SE for a given site.

Usage:

dirac-admin-set-site-protocols [options] ... Protocol [Protocol]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Site=                  : Site for which protocols are to be set (mandatory)

Arguments:

Protocol:  SE access protocol (optional)

Example:

$ dirac-admin-set-site-protocols --Site=LCG.IN2P3.fr SRM2

dirac-admin-site-info

Print Configuration information for a given Site

Usage:

dirac-admin-site-info [options] ... Site [Site]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Site:  Name of the Site

Example:

$ dirac-admin-site-info LCG.IN2P3.fr
{'CE': 'cclcgceli01.in2p3.fr, cclcgceli03.in2p3.fr, sbgce1.in2p3.fr',
 'Coordinates': '4.8655:45.7825',
 'Mail': 'grid.admin@cc.in2p3.fr',
 'MoUTierLevel': '1',
 'Name': 'IN2P3-CC',
 'SE': 'IN2P3-disk, DIRAC-USER'}

dirac-admin-site-mask-logging

Retrieves site mask logging information.

Usage:

dirac-admin-site-mask-logging [options] ... Site [Site]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Site:  Name of the Site

Example:

$ dirac-admin-site-mask-logging LCG.IN2P3.fr
Site Mask Logging Info for LCG.IN2P3.fr
Active  2010-12-08 21:28:16 ( atsareg )

dirac-admin-sync-users-from-file

Sync users in Configuration with the cfg contents.

Usage:

dirac-admin-sync-users-from-file [options] ... UserCfg

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-t  --test                   : Only test. Don't commit changes

Arguments:

UserCfg:  Cfg FileName with Users as sections containingDN, Groups, and other properties as options

Example:

$ dirac-admin-sync-users-from-file file_users.cfg

dirac-dms-get-file

Retrieve a single file or list of files from Grid storage to the current directory.

Usage:

dirac-dms-get-file [options] ... LFN [LFN]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LFN:  Logical File Name or file containing LFNs

Example:

$ dirac-dms-get-file /formation/user/v/vhamar/Example.txt
{'Failed': {},
 'Successful': {'/formation/user/v/vhamar/Example.txt': '/afs/in2p3.fr/home/h/hamar/Tests/DMS/Example.txt'}}

dirac-dms-lfn-accessURL

Retrieve an access URL for an LFN replica given a valid DIRAC SE.

Usage:

dirac-dms-lfn-accessURL [options] ... LFN SE PROTO

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LFN:    Logical File Name or file containing LFNs
SE:     Valid DIRAC SE
PROTO:  Optional protocol for accessURL (optional)

Example:

$ dirac-dms-lfn-accessURL /formation/user/v/vhamar/Example.txt DIRAC-USER
{'Failed': {},
 'Successful': {'/formation/user/v/vhamar/Example.txt': 'dips://dirac.in2p3.fr:9148/DataManagement/StorageElement   /formation/user/v/vhamar/Example.txt'}}

dirac-dms-lfn-metadata

Obtain replica metadata from file catalogue client.

Usage:

dirac-dms-lfn-metadata [options] ... LFN [LFN]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LFN:  Logical File Name or file containing LFNs

Example:

$ dirac-dms-lfn-metadata /formation/user/v/vhamar/test.txt
{'Failed': {},
 'Successful': {'/formation/user/v/vhamar/test.txt': {'Checksum': 'eed20d47',
                                                      'ChecksumType': 'Adler32',
                                                      'CreationDate': datetime.datetime(2011, 2, 11, 14, 52, 47),
                                                      'FileID': 250L,
                                                      'GID': 2,
                                                      'GUID': 'EDE6DDA4-3344-3F39-A993-8349BA41EB23',
                                                      'Mode': 509,
                                                      'ModificationDate': datetime.datetime(2011, 2, 11, 14, 52, 47),
                                                      'Owner': 'vhamar',
                                                      'OwnerGroup': 'dirac_user',
                                                      'Size': 34L,
                                                      'Status': 1,
                                                      'UID': 2}}}

dirac-dms-lfn-replicas

Obtain replica information from file catalogue client.

Usage:

dirac-dms-lfn-replicas [options] ... LFN [LFN]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-a  --All                    :   Also show inactive replicas

Arguments:

LFN:  Logical File Name or file containing LFNs

Example:

$ dirac-dms-lfn-replicas /formation/user/v/vhamar/Test.txt
{'Failed': {},
 'Successful': {'/formation/user/v/vhamar/Test.txt':   {'M3PEC-disk': 'srm://se0.m3pec.u-bordeaux1.fr/dpm/m3pec.u-bordeaux1.fr/home/formation/user/v/vhamar/Test.txt'}}}

dirac-dms-pfn-accessURL

Retrieve an access URL for a PFN given a valid DIRAC SE

Usage:

dirac-dms-pfn-accessURL [options] ... PFN SE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

PFN:  Physical File Name or file containing PFNs
SE:   Valid DIRAC SE

dirac-dms-pfn-metadata

Retrieve metadata for a PFN given a valid DIRAC SE

Usage:

dirac-dms-pfn-metadata [options] ... PFN SE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

PFN:  Physical File Name or file containing PFNs
SE:   Valid DIRAC SE

dirac-dms-replicate-lfn

Replicate an existing LFN to another Storage Element

Usage:

dirac-dms-replicate-lfn [options] ... LFN Dest Source Cache

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LFN:     Logical File Name or file containing LFNs
Dest:    Valid DIRAC SE
Source:  Valid DIRAC SE (optional)
Cache:   Local directory to be used as cache (optional)

Example:

$ dirac-dms-replicate-lfn /formation/user/v/vhamar/Test.txt DIRAC-USER
{'Failed': {},
 'Successful': {'/formation/user/v/vhamar/Test.txt': {'register': 0.50833415985107422,
                                                      'replicate': 11.878520965576172}}}

dirac-framework-ping-service

Ping the given DIRAC Service

Usage:

dirac-framework-ping-service [options] ... <URL|System/Service|System> Service

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

URL:             URL of the service to ping (instead of System and Service)
System/Service:  Full component name (ie: WorkloadManagement/Matcher)
System:          Name of the DIRAC system (ie: WorkloadManagement)
Service:         Name of the DIRAC service (ie: Matcher) (optional)

Example:

$ dirac-framework-ping-service WorkloadManagement PilotManager
{'OK': True,
 'Value': {'cpu times': {'children system time': 0.0,
                         'children user time': 0.0,
                         'elapsed real time': 8778481.7200000007,
                         'system time': 54.859999999999999,
                         'user time': 361.06999999999999},
           'host uptime': 4485212L,
           'load': '3.44 3.90 4.02',
           'name': 'WorkloadManagement/PilotManager',
           'service start time': datetime.datetime(2011, 2, 21, 8, 58, 35, 521438),
           'service uptime': 85744,
           'service url': 'dips://dirac.in2p3.fr:9171/WorkloadManagement/PilotManager',
           'time': datetime.datetime(2011, 3, 14, 11, 47, 40, 394957),
           'version': 'v5r12-pre9'},
 'rpcStub': (('WorkloadManagement/PilotManager',
              {'delegatedDN': '/O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar',
               'delegatedGroup': 'dirac_user',
               'skipCACheck': True,
               'timeout': 120}),
             'ping',
             ())}

dirac-framework-self-ping

Performs a DIPS ping on a given target and exit with the return code.

It uses the local host certificate The target is specified as “”<port>/System/Service” The script does not print anything, and just exists with 0 in case of success, or 1 in case of error

Usage:

dirac-framework-self-ping [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-repo-monitor

Monitor the jobs present in the repository

Usage:

dirac-repo-monitor [options] ... RepoDir

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

RepoDir:  Location of Job Repository

dirac-utils-file-adler

Calculate alder32 of the supplied file

Usage:

dirac-utils-file-adler [options] ... File [File]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

File:  File Name

Example:

$ dirac-utils-file-adler Example.tgz
Example.tgz 88b4ca8b

dirac-utils-file-md5

Calculate md5 of the supplied file

Usage:

dirac-utils-file-md5 [options] ... File [File]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

File:  File Name

Example:

$ dirac-utils-file-md5 Example.tgz
Example.tgz 5C1A1102-EAFD-2CBA-25BD-0EFCCFC3623E

dirac-wms-get-normalized-queue-length

Report Normalized CPU length of queue

This script was used by the dirac-pilot script to set the CPUTime limit for the matching but now this is no more the case.

Usage:

dirac-wms-get-normalized-queue-length [options] ... Queue [Queue]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Queue:  GlueCEUniqueID of the Queue (ie, juk.nikhef.nl:8443/cream-pbs-lhcb)

Example:

$ dirac-wms-get-normalized-queue-length  cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long
cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long 857400.0

dirac-wms-get-queue-normalization

Report Normalization Factor applied by Site to the given Queue

Usage:

dirac-wms-get-queue-normalization [options] ... Queue [Queue]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Queue:  GlueCEUniqueID of the Queue (ie, juk.nikhef.nl:8443/cream-pbs-lhcb)

Example:

$ dirac-wms-get-queue-normalization cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long
cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long 2500.0

dirac-wms-job-attributes

Retrieve attributes associated with the given DIRAC job

Usage:

dirac-wms-job-attributes [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-attributes  1
{'AccountedFlag': 'False',
 'ApplicationNumStatus': '0',
 'ApplicationStatus': 'Unknown',
 'CPUTime': '0.0',
 'DIRACSetup': 'EELA-Production',
 'DeletedFlag': 'False',
 'EndExecTime': '2011-02-14 11:28:01',
 'FailedFlag': 'False',
 'HeartBeatTime': '2011-02-14 11:28:01',
 'ISandboxReadyFlag': 'False',
 'JobGroup': 'NoGroup',
 'JobID': '1',
 'JobName': 'DIRAC_vhamar_602138',
 'JobSplitType': 'Single',
 'JobType': 'normal',
 'KilledFlag': 'False',
 'LastUpdateTime': '2011-02-14 11:28:11',
 'MasterJobID': '0',
 'MinorStatus': 'Execution Complete',
 'OSandboxReadyFlag': 'False',
 'Owner': 'vhamar',
 'OwnerDN': '/O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar',
 'OwnerGroup': 'eela_user',
 'RescheduleCounter': '0',
 'RescheduleTime': 'None',
 'RetrievedFlag': 'False',
 'RunNumber': '0',
 'Site': 'EELA.UTFSM.cl',
 'StartExecTime': '2011-02-14 11:27:48',
 'Status': 'Done',
 'SubmissionTime': '2011-02-14 10:12:40',
 'SystemPriority': '0',
 'UserPriority': '1',
 'VerifiedFlag': 'True'}

dirac-wms-job-delete

Delete DIRAC job from WMS, if running it will be killed

Usage:

dirac-wms-job-delete [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --File <value>           : Get output for jobs with IDs from the file
-g  --JobGroup <value>       : Get output for jobs in the given group

Arguments:

JobID:  DIRAC Job ID (optional)

Example:

$ dirac-wms-job-delete 12
Deleted job 12

dirac-wms-job-get-input

Retrieve input sandbox for DIRAC Job

Usage:

dirac-wms-job-get-input [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --Dir <value>            : Store the output in this directory

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-get-input 13
Job input sandbox retrieved in InputSandbox13/

dirac-wms-job-get-jdl

Retrieve the current JDL of a DIRAC job

Usage:

dirac-wms-job-get-jdl [options] ... JobID ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-O  --Original               : Gets the original JDL

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-get-jdl 1
{'Arguments': '-ltrA',
 'CPUTime': '86400',
 'DIRACSetup': 'EELA-Production',
 'Executable': '/bin/ls',
 'JobID': '1',
 'JobName': 'DIRAC_vhamar_602138',
 'JobRequirements': '[OwnerDN = /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar;
                      OwnerGroup = eela_user;
                      Setup = EELA-Production;
                      UserPriority = 1;
                      CPUTime = 0 ]',
 'OutputSandbox': ['std.out', 'std.err'],
 'Owner': 'vhamar',
 'OwnerDN': '/O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar',
 'OwnerGroup': 'eela_user',
 'OwnerName': 'vhamar',
 'Priority': '1'}

dirac-wms-job-get-output

Retrieve output sandbox for a DIRAC job

Usage:

dirac-wms-job-get-output [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --Dir <value>            : Store the output in this directory
-f  --File <value>           : Get output for jobs with IDs from the file
-g  --JobGroup <value>       : Get output for jobs in the given group

Arguments:

JobID:  DIRAC Job ID or a name of the file with JobID per line (optional)

Example:

$ dirac-wms-job-get-output 1
Job output sandbox retrieved in 1/

dirac-wms-job-get-output-data

Retrieve the output data files of a DIRAC job

Usage:

dirac-wms-job-get-output-data [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --Dir <value>            : Store the output in this directory

Arguments:

JobID:  DIRAC Job ID

dirac-wms-job-kill

Issue a kill signal to a running DIRAC job

Usage:

dirac-wms-job-kill [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-kill 1918
Killed job 1918

Note

  • jobs will not disappear from JobDB until JobCleaningAgent has deleted them

  • jobs will be deleted “immediately” if they are in the status ‘Deleted’

  • USER jobs will be deleted after a grace period if they are in status Killed, Failed, Done

What happens when you hit the “kill job” button

  • if the job is in status ‘Running’, ‘Matched’, ‘Stalled’ it will be properly killed, and then its status will be marked as ‘Killed’

  • otherwise, it will be marked directly as ‘Killed’.

dirac-wms-job-logging-info

Retrieve history of transitions for a DIRAC job

Usage:

dirac-wms-job-logging-info [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-logging-info 1
Status                        MinorStatus                         ApplicationStatus             DateTime
Received                      Job accepted                        Unknown                       2011-02-14 10:12:40
Received                      False                               Unknown                       2011-02-14 11:03:12
Checking                      JobSanity                           Unknown                       2011-02-14 11:03:12
Checking                      JobScheduling                       Unknown                       2011-02-14 11:03:12
Waiting                       Pilot Agent Submission              Unknown                       2011-02-14 11:03:12
Matched                       Assigned                            Unknown                       2011-02-14 11:27:17
Matched                       Job Received by Agent               Unknown                       2011-02-14 11:27:27
Matched                       Submitted To CE                     Unknown                       2011-02-14 11:27:38
Running                       Job Initialization                  Unknown                       2011-02-14 11:27:42
Running                       Application                         Unknown                       2011-02-14 11:27:48
Completed                     Application Finished Successfully   Unknown                       2011-02-14 11:28:01
Completed                     Uploading Output Sandbox            Unknown                       2011-02-14 11:28:04
Completed                     Output Sandbox Uploaded             Unknown                       2011-02-14 11:28:07
Done                          Execution Complete                  Unknown                       2011-02-14 11:28:07

dirac-wms-job-parameters

Retrieve parameters associated to the given DIRAC job

Usage:

dirac-wms-job-parameters [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-parameters 1
{'CPUNormalizationFactor': '6.8',
 'GridCEQueue': 'ce.labmc.inf.utfsm.cl:2119/jobmanager-lcgpbs-prod',
 'HostName': 'wn05.labmc',
 'JobPath': 'JobPath,JobSanity,JobScheduling,TaskQueue',
 'JobSanityCheck': 'Job: 1 JDL: OK,InputData: No input LFNs,  Input Sandboxes: 0, OK.',
 'JobWrapperPID': '599',
 'LocalAccount': 'prod006',
 'LocalBatchID': '',
 'LocalJobID': '277821.ce.labmc.inf.utfsm.cl',
 'MatcherServiceTime': '2.27646398544',
 'Memory(kB)': '858540kB',
 'ModelName': 'Intel(R)Xeon(R)CPU5110@1.60GHz',
 'NormCPUTime(s)': '1.02',
 'OK': 'True',
 'OutputSandboxMissingFiles': 'std.err',
 'PayloadPID': '604',
 'PilotAgent': 'EELADIRAC v1r1; DIRAC v5r12',
 'Pilot_Reference': 'https://lb2.eela.ufrj.br:9000/ktM6WWR1GdkOTm98_hwM9Q',
 'ScaledCPUTime': '115.6',
 'TotalCPUTime(s)': '0.15'}

dirac-wms-job-peek

Peek StdOut of the given DIRAC job

Usage:

dirac-wms-job-peek [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-peek 1

dirac-wms-job-reschedule

Reschedule the given DIRAC job

Usage:

dirac-wms-job-reschedule [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-wms-job-reschedule 1
Rescheduled job 1

dirac-wms-job-status

Retrieve status of the given DIRAC job

Usage:

dirac-wms-job-status [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --File <value>           : Get status for jobs with IDs from the file
-g  --JobGroup <value>       : Get status for jobs in the given group

Arguments:

JobID:  DIRAC Job ID (optional)

Example:

$ dirac-wms-job-status 2
JobID=2 Status=Done; MinorStatus=Execution Complete; Site=EELA.UTFSM.cl;

dirac-wms-job-submit

Submit jobs to DIRAC WMS

Usage:

dirac-wms-job-submit [options] ... JDL [JDL]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --File <value>           : Writes job ids to file <value>
-r  --UseJobRepo <value>     : Use the job repository

Arguments:

JDL:  Path to JDL file

Example:

$ dirac-wms-job-submit Simple.jdl
JobID = 11

dirac-wms-select-jobs

Select DIRAC jobs matching the given conditions

Usage:

dirac-wms-select-jobs [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Status=                : Primary status
--MinorStatus=           : Secondary status
--ApplicationStatus=     : Application status
--Site=                  : Execution site
--Owner=                 : Owner (DIRAC nickname)
--JobGroup=              : Select jobs for specified job group
--Date=                  : Date in YYYY-MM-DD format, if not specified default is today
--Maximum=               : Maximum number of jobs shown (default 100, 0 means all)

dkill

Kill or delete DIRAC job

Usage:

dkill [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --delete                 : delete job
-a  --all                    : select all jobs
-v  --verbose                : verbose output

Arguments:

JobID:  DIRAC Job ID

dlogging

Retrieve logging information for a DIRAC job

Usage:

dlogging [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-f  --Fmt <value>            : display format (pretty, csv, json)

Arguments:

JobID:  DIRAC Job ID

dls

Lists files or directories in the file catalogue. Uses the user’s home directory as specified in dcommands.conf as its base directory.

Examples:

$ dls
$ dls ..
$ dls /

Usage:

dls [options] ... Path [Path]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-l  --long                   : detailled listing
-L  --list-replicas          : detailled listing with replicas
-t  --time                   : time based order
-r  --reverse                : reverse sort order
-n  --numericid              : numeric UID and GID
-S  --size                   : size based order
-H  --human-readable         : size human readable

Arguments:

Path:  path to file (optional)

dmeta

Manipulate metadata in the FileCatalog.

Usage:

list metadata indices: dmeta -I
add metadata index: dmeta -i f|d meta=(int|float|string|date)
delete metadata index: dmeta -i -r [metadata]
or
manipulate metadata for lfn: dmeta add|rm|ls [lfn] meta[=value]

Examples:

$ dmeta add ./some_lfn_file some_meta="some_value"',
$ dmeta -i f testindex=int
$ dmeta ls ./some_lfn_file",
$ dmeta rm ./some_lfn_file some_meta",

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-i  --index <value>          : set or remove metadata indices
-I  --list-index             : list defined metadata indices

dmkdir

Creates a directory in the FileCatalog. Takes either an absolute path or a path relative to the user’s current file catalogue directory.

Examples:

$ dmkdir some_lfn_dir (relative path)
$ dmkdir ./some_lfn_dir (relative path)
$ dmkdir /voname/somesubdir/anotherone/newdir

Usage:

dmkdir [options] ... Path [Path]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Path:  path to new directory

doutput

Retrieve output sandbox for a DIRAC job

Usage:

doutput [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --OutputDir <value>      : destination directory
    --Data                   : download output data instead of output sandbox
    --Sandbox                : download output sandbox, even if data was required
-v  --verbose                : verbose output
-n  --NoJobDir               : do not create job directory
-g  --JobGroup <value>       : Get output for jobs in the given group
-i  --input-file <value>     : read JobIDs from file

Arguments:

JobID:  DIRAC Job ID (optional)

dput

Uploads a file to an SE and registers it in the file catalog.

Usage:

dput [options] local_path[... lfn]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --destination-se <value>  : Storage Element where to put replica
-r  --recursive              : recursively put contents of local_path

Arguments:

local_path:   local file
lfn:          file or directory entry in the file catalog

Examples:

$ dput some_local_file ./some_lfn_file
$ dput local_file1 local_file2 ./some_lfn_dir/

dpwd

Prints the current file datalogue directory.

Usage:

dpwd [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

drepl

replicate file in the FileCatalog

Can work in two modes.

In the first mode, yuser provides the destination SE with option “-D”. In the second mode, when no destination is given, drepl will look for configuration options “replication_scheme” and “replication_ses”. If found, those variables will define a list of SEs where to put replicas. If not found drepl will fallback to configuration option “default_se”.

Supported schemes for automated replication (in option “replication_scheme”) are:

* all() - replicate file to all SEs listed in option "replication_ses"
* first(N) - replicate file to N first SEs listed in option "replication_ses"
* random(N) - replicatefile to N randomly chosen SEs from the list in option "replication_ses"
Examples

$ drepl ./some_lfn_file $ drepl -D SOME-DESTINATION-SE-disk ./some_lfn_file

Usage:

drepl [options] ... lfn [lfn]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --destination-se <value>  : Storage Element where to put replica (or a comma separated list)
-S  --source-se <value>      : source Storage Element for replication

Arguments:

lfn:  file entry in the FileCatalog

dreplicas

Print list replicas for files in the FileCatalog

Usage:

dreplicas [options] ... lfn [lfn]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

lfn:  logical file name

drm

Remove files from the FileCatalog (and all replicas from Storage Elements)

Examples:

$ drm ./some_lfn_file

Usage:

drm [options] ... lfn [lfn]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-F  --lfnFile <value>        : file containing a list of LFNs
-D  --destination-se <value>  : Storage Element from where to remove replica
-r  --                       : remove directory recursively

Arguments:

lfn:  logical file name (optional)

drmdir

remove FileCatalog directories. Attention ! This command does not remove directories and files on the physical storage.

Examples:

$ drmdir ./some_lfn_directory

Usage:

drmdir [options] ... Path [Path]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Path:  directory path

dsize

Print file or directory disk usage as recorded in the file catalog.

Usage:

dsize [options] [path]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-l  --long                   : detailled listing
-f  --raw-files              : reverse sort order

Arguments:

path:  file/directory path (optional)

dstat

Retrieves job status according to given criteria.

Example:

$ dstat -a -u your.dirac.username

Usage:

dstat [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-u  --User <value>           : job owner
-S  --Status <value>         : select job by status (comma separated list of statuses in: Submitting,Received,Checking,Staging,Waiting,Matched,Rescheduled,Running,Stalled,Completing,Done,Completed,Failed,Deleted,Killed)
-a  --StatusAll              : display jobs of any status
-g  --JobGroup <value>       : select job by job group
-n  --JobName <value>        : select job by job name
-f  --Fmt <value>            : display format (pretty, csv, json)
-D  --JobDate <value>        : age of jobs to display (in days)
-F  --Fields <value>         : display list of job fields (comma separated list of fields. e.g. Owner,JobName,OwnerGroup,JobGroup,Site,Status,MinorStatus,SubmissionTime,JobType,ApplicationStatus,StartExecTime,EndExecTime,CPUTime)
-i  --input-file <value>     : read JobIDs from file

Arguments:

JobID:  DIRAC Job ID (optional)

Example:

$ dstat -a -u your.dirac.username

dsub

Submit jobs to DIRAC WMS

Default JDL can be configured from session in the “JDL” option

Usage:

dsub [options] ... executable arguments [arguments]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-J  --JDL <value>            : JDL file or inline
-N  --JobName <value>        : job name
-E  --StdError <value>       : job standard error file
-O  --StdOutput <value>      : job standard output file
    --OutputSandbox=         : job output sandbox
    --InputSandbox=          : job input sandbox
    --OutputData=            : job output data
    --InputData=             : job input data
    --OutputPath=            : job output data path prefix
    --OutputSE=              : job output data SE
    --CPUTime=               : job CPU time limit (in seconds)
    --Site=                  : job Site list
    --BannedSite=            : job Site exclusion list
    --Platform=              : job Platform list
    --Priority=              : job priority
    --JobGroup=              : job JobGroup
    --Parametric=            : comma separated list or named parameters or number loops (in the form<start>:<stop>[:<step>[:<factor>]])
    --ForceExecUpload        : Force upload of executable with InputSandbox
-v  --verbose                : verbose output

Arguments:

executable:  command to be run inside the job.
          If a relative path, local file will be included in InputSandbox
          If no executable is given and JDL (provided or default) doesn't contain one,
          standard input will be read for executable contents (optional)
arguments:   arguments to pass to executable
         if some arguments are to begin with a dash '-', prepend '--' before them (optional)

Production

dirac-prod-add-trans

Add an existing transformation to an existing production. Transformations already belonging to another production cannot be added.

Usage:

dirac-prod-add-trans [options] ... prodID transID parentTransID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:         Production ID
transID:        Transformation ID
parentTransID:  Parent Transformation ID (optional)

dirac-prod-clean

Clean a given production

Usage:

dirac-prod-clean [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

dirac-prod-complete

Complete a given production

Usage:

dirac-prod-complete [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

Example:

$ dirac-prod-complete 312

dirac-prod-delete

Delete a given production

Usage:

dirac-prod-delete [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

dirac-prod-get

Get informations for a given production

Usage:

dirac-prod-get [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

Example:

$ dirac-prod-get 381

dirac-prod-get-all

Get summary informations of all productions

Usage:

dirac-prod-get-all [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-prod-get-description

Get the description of a given production

Usage:

dirac-prod-get-description [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

Example:

$ dirac-prod-get-description 381

dirac-prod-get-trans

Get the transformations belonging to a given production

Usage:

dirac-prod-get-trans [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

Example:

$ dirac-prod-get-trans 381

dirac-prod-start

Start a given production

Usage:

dirac-prod-start [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

Example:

$ dirac-prod-start 381

dirac-prod-stop

Stop a given production

Usage:

dirac-prod-stop [options] ... prodID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

prodID:  Production ID

Example:

$ dirac-prod-stop 381

RequestManagement

dirac-rms-list-req-cache

List the number of requests in the caches of all the ReqProxyies

Usage:

dirac-rms-list-req-cache [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Full                   :    Print full list of requests

dirac-rms-reqdb-summary

Show ReqDB summary

Usage:

dirac-rms-reqdb-summary [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-rms-request

Show request given its ID, a jobID or a transformation and a task

Usage:

dirac-rms-request [options] ... <file|request> request [request]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Job=                   :    JobID[,jobID2,...]
--Transformation=        :    transformation ID
--Tasks=                 :       Associated to --Transformation, list of taskIDs
--Verbose                :    Print more information
--Terse                  :    Only print request status
--Full                   :    Print full request content
--Status=                :    Select all requests in a given status
--Since=                 :       Associated to --Status, start date yyyy-mm-dd or nb of days (default= -one day
--Until=                 :       Associated to --Status, end date (default= now
--Maximum=               :       Associated to --Status, max number of requests
--Reset                  :    Reset Failed files to Waiting if any
--Force                  :    Force reset even if not Failed
--All                    :       (if --Status Failed) all requests, otherwise exclude irrecoverable failures
--FixJob                 :    Set job Done if the request is Done
--Cancel                 :    Cancel the request
--ListJobs               :  List the corresponding jobs
--TargetSE=              :  Select request only if that SE is in the targetSEs

Arguments:

file:     a file containing a list of requests (Comma-separated on each line) (optional)
request:  a request ID or a unique request name (optional)

ResourceStatus

dirac-rss-list-status

Script that dumps the DB information for the elements into the standard output. If returns information concerning the StatusType and Status attributes.

Usage:

dirac-rss-list-status [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--element=               : Element family to be Synchronized ( Site, Resource or Node )
--elementType=           : ElementType narrows the search; None if default
--name=                  : ElementName; None if default
--tokenOwner=            : Owner of the token; None if default
--statusType=            : StatusType; None if default
--status=                : Status; None if default
--VO=                    : Virtual organisation; None if default

dirac-rss-query-db

Script that dumps the DB information for the elements into the standard output. If returns information concerning the StatusType and Status attributes.

Usage:

dirac-rss-query-db [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--element=               : Element family to be Synchronized ( Site, Resource, Node )
--tableType=             : A valid table type (Status, Log, History)
--name=                  : ElementName (comma separated list allowed); None if default
--statusType=            : A valid StatusType argument (it admits a comma-separated list of statusTypes); None if default
--status=                : A valid Status argument ( Active, Probing, Degraded, Banned, Unknown, Error ); None if default
--elementType=           : ElementType narrows the search; None if default
--reason=                : Decision that triggered the assigned status
--lastCheckTime=         : Time-stamp setting last time the status & status were checked
--tokenOwner=            : Owner of the token ( to specify only with select/delete queries
--VO=                    : Virtual organisation; None if default

dirac-rss-query-dtcache

Select/Add/Delete a new DownTime entry for a given Site or Service.

Usage:

dirac-rss-query-dtcache [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--downtimeID=            : ID of the downtime
--element=               : Element (Site, Service) affected by the downtime
--name=                  : Name of the element
--startDate=             : Starting date of the downtime
--endDate=               : Ending date of the downtime
--severity=              : Severity of the downtime (Warning, Outage)
--description=           : Description of the downtime
--link=                  : URL of the downtime announcement
--ongoing                : To force "select" to return the ongoing downtimes

dirac-rss-set-status

Script that facilitates the modification of a element through the command line. However, the usage of this script will set the element token to the command issuer with a duration of 1 day.

Usage:

dirac-rss-set-status [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--element=               : Element family to be Synchronized ( Site, Resource or Node )
--name=                  : Name (or comma-separeted list of names) of the element where the change applies
--statusType=            : StatusType (or comma-separeted list of names), if none applies to all possible statusTypes
--status=                : Status to be changed
--reason=                : Reason to set the Status
--VO=                    : VO to change a status for. When omitted, status will be changed for all VOs

dirac-rss-set-token

Script that helps setting the token of the elements in RSS. It can acquire or release the token.

If the releaseToken switch is used, no matter what was the previous token, it will be set to rs_svc (RSS owns it). If not set, the token will be set to whatever username is defined on the proxy loaded while issuing this command. In the second case, the token lasts one day.

Usage:

dirac-rss-set-token [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--element=               : Element family to be Synchronized ( Site, Resource or Node )
--name=                  : Name, name of the element where the change applies
--statusType=            : StatusType, if none applies to all possible statusTypes
--reason=                : Reason to set the Status
--days=                  : Number of days the token is acquired
--releaseToken           : Release the token and let the RSS take control
--VO=                    : VO to set a token for. When omitted token will be set for all VOs

dirac-rss-sync

Script that synchronizes the resources described on the CS with the RSS. By default, it sets their Status to Unknown, StatusType to all and reason to Synchronized. However, it can copy over the status on the CS to the RSS. Important: If the StatusType is not defined on the CS, it will set it to Banned !

Usage:

dirac-rss-sync [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--init                   : Initialize the element to the status in the CS ( applicable for StorageElements )
--element=               : Element family to be Synchronized ( Site, Resource or Node ) or `all`
--defaultStatus=         : Default element status if not given in the CS

Resources

dirac-resource-get-parameters

Get parameters assigned to the CE

Usage:

dirac-resource-get-parameters [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-N  --Name <value>           : Computing Element Name (Mandatory)
-S  --Site <value>           : Site Name (Mandatory)
-Q  --Queue <value>          : Queue Name (Mandatory)

dirac-resource-info

Get information on resources available for the given VO: Computing and Storage. By default, resources for the VO corresponding to the current user identity are displayed

Usage:

dirac-resource-info [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-C  --ce                     : Get CE info
-S  --se                     : Get SE info
-V  --vo <value>             : Get resources for the given VO. If not set, taken from the proxy

StorageManagement

dirac-stager-monitor-file

Give monitoring information regarding a staging file uniquely identified with (LFN,SE)

  • status

  • last update

  • jobs requesting this file to be staged

  • SRM requestID

  • pin expiry time

  • pin length

Usage:

dirac-stager-monitor-file [options] ... LFN SE

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

LFN:  LFN of the staging file
SE:   Storage Element for the staging file

Example:

$ dirac-stager-monitor-file.py /lhcb/LHCb/Collision12/FULL.DST/00020846/0005/0_1.full.dst GRIDKA-RDST
--------------------
LFN     : /lhcb/LHCb/Collision12/FULL.DST/00020846/0005/0_1.full.dst
SE      : GRIDKA-RDST
PFN     : srm://gridka-dCache.fzk.de/pnfs/gridka.de/lhcb/LHCb/Collision12/FULL.DST/00020846/0005/0_1.full.dst
Status  : StageSubmitted
LastUpdate: 2013-06-11 18:13:40
Reason  : None
Jobs requesting this file to be staged: 48518896
------SRM staging request info--------------
SRM RequestID: -1768636375
SRM StageStatus: StageSubmitted
SRM StageRequestSubmitTime: 2013-06-11 18:13:38
SRM StageRequestCompletedTime: None
SRM PinExpiryTime: None
SRM PinLength: 43200

dirac-stager-monitor-jobs

Report the summary of the staging progress of jobs

Usage:

dirac-stager-monitor-jobs [options] ... JobID [JobID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

JobID:  DIRAC Job ID

Example:

$ dirac-stager-monitor-jobs.py 5688643 5688644


JobID               : 5688643
Status              : Offline
SubmitTime          : 2013-06-10 15:21:03
CompleteTime        : None


Staging files for this job::

    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00003705_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00003705_1.sdst
    Status  : Offline
    Reason  : None
    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00001918_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00001918_1.sdst
    Status  : Offline
    Reason  : None
    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00002347_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00002347_1.sdst
    Status  : Offline
    Reason  : None
    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00003701_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00003701_1.sdst
    Status  : Offline
    Reason  : None
----------------------
JobID               : 5688644
Status              : Offline
SubmitTime          : 2013-06-10 15:21:07
CompleteTime        : None


Staging files for this job::

    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00005873_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00005873_1.sdst
    Status  : Offline
    Reason  : None
    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00004468_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00004468_1.sdst
    Status  : Offline
    Reason  : None
    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00000309_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00000309_1.sdst
    Status  : Offline
    Reason  : None
    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00005911_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00005911_1.sdst
    Status  : Offline
    Reason  : None
    --------------------
    LFN     : /lhcb/LHCb/Collision10/SDST/01/0000/01_00003296_1.sdst
    SE      : IN2P3-RDST
    PFN     : srm://ccsrm.in2p3.fr/pnfs/in2p3.fr/data/lhcb/LHCb/Collision10/SDST/01/0000/01_00003296_1.sdst
    Status  : Offline
    Reason  : None
    --------------------

dirac-stager-monitor-request

Report the summary of the stage task from the DB.

Usage:

dirac-stager-monitor-request [options] ... Request

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

Request:  ID of the Stage request in the StorageManager

dirac-stager-monitor-requests

Report the details of file staging requests, based on selection filters

WARNING: Query may be heavy, please use –limit switch!

Usage:

dirac-stager-monitor-requests [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--status=                : Filter per file status=(New, Offline, Waiting, Failed, StageSubmitted, Staged).
                           If not used, all status values will be taken into account
--se=                    : Filter per Storage Element. If not used, all storage elements will be taken into account.
--limit=                 : Limit the number of entries returned.
--showJobs=              : Whether to ALSO list the jobs asking for these files to be staged

Example:

$ dirac-stager-show-requests.py --status=Staged --se=GRIDKA-RDST --limit=10 --showJobs=YES
Query limited to 10 entries


Status          LastUpdate           LFN              SE       Reason     Jobs       PinExpiryTime        PinLength
Staged   2013-06-05 20:10:50 /lhcb/LHCb/5.full.dst GRIDKA-RDST None    ['48498752']  2013-06-05 22:10:50  86400
Staged   2013-06-06 15:54:29 /lhcb/LHCb/1.full.dst GRIDKA-RDST None    ['48516851']  2013-06-06 16:54:29  43200
Staged   2013-06-07 02:35:41 /lhcb/LHCb/3.full.dst GRIDKA-RDST None    ['48520736']  2013-06-07 03:35:41  43200
Staged   2013-06-06 04:16:50 /lhcb/LHCb/3.full.dst GRIDKA-RDST None    ['48510852']  2013-06-06 06:16:50  86400
Staged   2013-06-07 03:44:04 /lhcb/LHCb/3.full.dst GRIDKA-RDST None    ['48520737']  2013-06-07 04:44:04  43200
Staged   2013-06-05 23:37:46 /lhcb/LHCb/3.full.dst GRIDKA-RDST None    ['48508687']  2013-06-06 01:37:46  86400
Staged   2013-06-10 08:50:09 /lhcb/LHCb/5.full.dst GRIDKA-RDST None    ['48518896']  2013-06-10 09:50:09  43200
Staged   2013-06-06 11:03:25 /lhcb/LHCb/2.full.dst GRIDKA-RDST None    ['48515583']  2013-06-06 12:03:25  43200
Staged   2013-06-06 11:11:50 /lhcb/LHCb/2.full.dst GRIDKA-RDST None    ['48515072']  2013-06-06 12:11:50  43200
Staged   2013-06-07 03:19:26 /lhcb/LHCb/2.full.dst GRIDKA-RDST None    ['48515600']  2013-06-07 04:19:26  43200

dirac-stager-show-stats

Reports breakdown of file(s) number/size in different staging states across Storage Elements. Currently used Cache per SE is also reported. (active pins)

Usage:

dirac-stager-show-stats [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Example:

$ dirac-stager-show-stats


 Status               SE                   NumberOfFiles        Size(GB)
--------------------------------------------------------------------------
 Staged               GRIDKA-RDST          1                    4.5535
 StageSubmitted       GRIDKA-RDST          5                    22.586
 Waiting              PIC-RDST             3                    13.6478


WARNING: the Size for files with Status=New is not yet determined at the point of selection!


 --------------------- current status of the SE Caches from the DB-----------
 GRIDKA-RDST    :      6 replicas with a size of 29.141 GB.

dirac-stager-stage-files

Submit staging requests for a particular Storage Element! Default DIRAC JobID will be =0. (not visible in the Job monitoring list though)

Usage:

dirac-stager-stage-files <LFN> <SE>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

<LFN>: LFN to Stage (or local file with list of LFNs)
<SE>:  Name of Storage Element

Example:

$ dirac-stager-stage-files.py filesToStage.txt GRIDKA-RDST


Stage request submitted for LFNs::

['/lhcb/LHCb/Collision12/FULL.DST/00020846/0002/00020846_00023458_1.full.dst',
'/lhcb/LHCb/Collision12/FULL.DST/00020846/0003/00020846_00032669_1.full.dst',
'/lhcb/LHCb/Collision12/FULL.DST/00020846/0003/00020846_00032666_1.full.dst']
SE= GRIDKA-RDST
You can check their status and progress with dirac-stager-monitor-file <LFN> <SE>


$ dirac-stager-stage-files.py /lhcb/LHCb/Collision12/FULL.DST/00020846/0003/00020846_00032641_1.full.dst GRIDKA-RDST


Stage request submitted for LFNs::

['/lhcb/LHCb/Collision12/FULL.DST/00020846/0003/00020846_00032641_1.full.dst']
SE= GRIDKA-RDST
You can check their status and progress with dirac-stager-monitor-file <LFN> <SE>

Transformation

dirac-production-runjoblocal

Module created to run failed jobs locally on a CVMFS-configured machine. It creates the necessary environment, downloads the necessary files, modifies the necessary files and runs the job

Usage:

dirac-production-runjoblocal [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-D  --Download <value>       : Set jobID here. Defines data acquisition as DownloadInputData
-I  --Protocol <value>       : Set jobID here. Defines data acquisition as InputDataByProtocol

dirac-transformation-add-files

Add files to an existing transformation

Usage:

dirac-transformation-add-files [options] ... TransID <LFN|FileName>

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

TransID:   transformation ID
LFN:       LFN
FileName:  file containing LFNs

dirac-transformation-archive

Archive a transformation

Usage:

dirac-transformation-archive [options] ... transID [transID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

transID:  transformation ID

dirac-transformation-clean

Clean a tranformation

Usage:

dirac-transformation-clean [options] ... transID [transID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

transID:  transformation ID

dirac-transformation-cli

Command to launch the Transformation Shell

Usage:

dirac-transformation-cli [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-transformation-get-files

Get the files attached to a transformation

Usage:

dirac-transformation-get-files [options] ... transID

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

transID:  transformation ID

dirac-transformation-information

This script allows one to print information about a (list of) transformations.

Usage:

dirac-transformation-information [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Information=           :    Specify which information is required

dirac-transformation-recover-data

Script to call the DataRecoveryAgent functionality by hand.

Usage:

dirac-transformation-recover-data [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-T  --TransID <value>        : TransID to Check/Fix
-X  --Enabled                : Enable the changes

dirac-transformation-remove-output

Remove the outputs produced by a transformation

Usage:

dirac-transformation-remove-output [options] ... transID [transID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

transID:  transformation ID

dirac-transformation-replication

Create one replication transformation for each MetaValue given Is running in dry-run mode, unless enabled with -x MetaValue and TargetSEs can be comma separated lists

Usage:

dirac-transformation-replication <MetaValue1[,val2,val3]> <TargetSEs> [-G<Files>] [-S<SourceSEs>][-N<ExtraName>] [-T<Type>] [-M<Key>] [-K...] -x

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-G  --GroupSize <value>      : Number of Files per transformation task
-R  --GroupName <value>      : TransformationGroup Name
-S  --SourceSEs <value>      : SourceSE(s) to use, comma separated list
-N  --Extraname <value>      : String to append to transformation name
-P  --Plugin <value>         : Plugin to use for transformation
-T  --Flavour <value>        : Flavour to create: Replication or Moving
-K  --MetaKey <value>        : Meta Key to use: TransformationID
-M  --MetaData <value>       : MetaData to use Key/Value Pairs: 'DataType:REC,'
-x  --Enable                 : Enable the transformation creation, otherwise dry-run

dirac-transformation-update-derived

Move files that are Unused or MaxReset from a parent production to its derived production. The argument is a list of productions: comma separated list of ranges (a range has the form p1:p2)

Usage:

dirac-transformation-update-derived [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--NoReset                : Don't reset the MaxReset files to Unused (default is to reset)

dirac-transformation-verify-outputdata

Runs checkTransformationIntegrity from ValidateOutputDataAgent on selected Tranformation

Usage:

dirac-transformation-verify-outputdata [options] ... transID [transID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

transID:  transformation ID

WorkloadManagement

dirac-admin-kill-pilot

Kill the specified pilot

Usage:

dirac-admin-kill-pilot [options] ... PilotRef

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

PilotRef:  pilot reference

dirac-admin-pilot-logging-info

Get Pilots Logging for specific Pilot UUID or Job ID.

WARNING: Only one option (either uuid or jobid) should be used.

Usage:

dirac-admin-pilot-logging-info [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-u  --uuid <value>           : get PilotsLogging for given Pilot UUID
-j  --jobid <value>          : get PilotsLogging for given Job ID

dirac-admin-show-task-queues

Show details of currently active Task Queues

Usage:

dirac-admin-show-task-queues [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-v  --verbose                : give max details about task queues
-t  --taskQueue <value>      : show this task queue only

Example:

$ dirac-admin-show-task-queues
Getting TQs..
* TQ 401
        CPUTime: 360
           Jobs: 3
        OwnerDN: /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
     OwnerGroup: dirac_user
       Priority: 1.0
          Setup: Dirac-Production

dirac-admin-sync-pilot

This is a simple script that can be used for synchronizing pilot files to the current directory.

Usage:

dirac-admin-sync-pilot [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-n  --noMasterCS             : do not include master CS

dirac-jobexec

The dirac-jobexec script is equipped to execute workflows that

are specified via their XML description. The main client of this script is the Job Wrapper.

Usage:

dirac-jobexec [options] ... jobXMLfile

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-p  --parameter <value>      : Parameters that are passed directly to the workflow

Arguments:

jobXMLfile:  specify path to the Job XML file description

dirac-vm-cli

Usage:

dirac-vm-cli [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

dirac-vm-endpoint-status

Get VM instances available in the configured cloud sites

Usage:

dirac-vm-endpoint-status [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-S  --Site <value>           : Site Name
-C  --CE <value>             : Cloud Endpoint Name
-I  --Image <value>          : Image Name
-v  --vo <value>             : VO name

dirac-vm-get-pilot-output

Get pilot output from a VM

Usage:

dirac-vm-get-pilot-output [options] ... pilotRef

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

pilotRef:  pilot reference

dirac-vm-instance-stop

Get VM instances available in the configured cloud sites

Usage:

dirac-vm-instance-stop [options] ... site CE node

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Arguments:

site:  Site name
CE:    Cloud Endpoint Name
node:  node name

dirac-wms-cpu-normalization

Determine Normalization for current CPU. The main users of this script are the pilot jobs.

Pilots invoke dirac-wms-cpu-normalization which - runs 1 iteration of singleDiracBenchmark(1) (for single processors only)

  • stores in local cfg the following:

    LocalSite
    {
      CPUNormalizationFactor = 23.7 # corrected value (by JobScheduling/CPUNormalizationCorrection)
      DB12measured = 15.4
    }
    

Usage:

dirac-wms-cpu-normalization [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-N  --NumberOfProcessors <value>  : Run n parallel copies of the benchmark
-U  --Update                 : Update dirac.cfg with the resulting value
-R  --Reconfig <value>       : Update given configuration file with the resulting value

dirac-wms-get-queue-cpu-time

Report CPU length of queue, in seconds This script is used by the dirac-pilot script to set the CPUTime left, which is a limit for the matching

Usage:

dirac-wms-get-queue-cpu-time [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-C  --CPUNormalizationFactor <value>  : CPUNormalizationFactor, in case it is known

dirac-wms-get-wn

Get WNs for a selection of jobs

Usage:

dirac-wms-get-wn [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Site=                  :    Select site (default: BOINC.World.org)
--Status=                :    Select status (default: ['Running'])
--MinorStatus=           :    Select minor status
--WorkerNode=            :   Select WN
--BatchID=               :   Select batch jobID
--Since=                 :    Date since when to select jobs, or number of days (default: today)
--Date=                  :    Specify the date (check for a full day)
--Full                   :    Printout full list of job (default: False except if --WorkerNode)

dirac-wms-get-wn-parameters

Determine number of processors and memory for the worker node

Usage:

dirac-wms-get-wn-parameters [options] ...

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-N  --Name <value>           : Computing Element Name (Mandatory)
-S  --Site <value>           : Site Name (Mandatory)
-Q  --Queue <value>          : Queue Name (Mandatory)

dirac-wms-match

Get computing resources capable to execute a job with the given description.

Note that only statically defined computing resource parameters are considered although sites can fail matching due to their dynamic state, e.g. occupancy by other jobs. Also input data proximity is not taken into account.

Usage:

dirac-wms-match [options] ... job_JDL

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

-F  --full-match             : Check all the matching criteria
-S  --site <value>           : Check matching for these sites (comma separated list)

Arguments:

job_JDL:  file with job JDL description

dirac-wms-pilot-job-info

Retrieve info about jobs run by the given pilot

Usage:

dirac-wms-pilot-job-info [options] ... PilotID [PilotID]

General options:

-o  --option <value>         : Option=value to add
-s  --section <value>        : Set base section for relative parsed options
-c  --cert <value>           : Use server certificate to connect to Core Services
-d  --debug                  : Set debug mode (-ddd is extra debug)
    --cfg=                   : Load additional config file
    --autoreload             : Automatically restart if there's any change in the module
    --license                : Show DIRAC's LICENSE
-h  --help                   : Shows this help

Options:

--Parameters=            :    List of strings to be matched by job parameters or attributes

Arguments:

PilotID:  Grid ID of the pilot