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> : Set <cename> as Computing Element name
-V --VO <value> : Set the VO name
-K --LegacyExchangeApiKey <value> : Set the Api Key to talk to DiracX
--DiracxUrl= : Set the URL to talk to DiracX
-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
options:
-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
Optionally replicate files to SourceSE
ArchiveFiles: Create a tarball from input files, upload tarball to TarballSE
ReplicateAndRegister Tarball to TargetSE
Optionally: Add LFNs to an ArchiveSE
Optionally: Check for Tarball Migration
Remove all other replicas for these files, or remove all files
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 to use (default - Catalog defined for the users' VO)
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.
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
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
-
DN : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
group : dirac_pilot
not after : 2011-06-29 12:04:27
-
DN : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar
group : dirac_user
not after : 2011-06-29 12:04:30
dirac-diracx-whoami
Query DiracX for information about the current user
This is a stripped down version of the “dirac whoami” script from DiracX. It primarily exists as a method of validating the current user’s credentials are functional.
Usage:
dirac-diracx-whoami [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-install-component
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/JobMonitoring)
System: Name of the DIRAC system (ie: WorkloadManagement)
Component: Name of the DIRAC service (ie: JobMonitoring) (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-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 | ExpirationTime |
-------------------------------------------------------------------------
| /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar | 2011-06-29 12:04:25 |
-------------------------------------------------------------------------
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
2024-04-17T16:10:16,274548Z Framework ALWAYS: Can’t load /home/docs/checkouts/readthedocs.org/user_builds/dirac/conda/integration/etc/dirac.cfg 2024-04-17T16:10:16,275035Z Framework ALWAYS: Might be OK if setting up the site 2024-04-17T16:10:16,275589Z Framework WARN: MySQL root password not found 2024-04-17T16:10:16,275732Z Framework WARN: Using ‘Dirac’ as MySQL user name 2024-04-17T16:10:16,275873Z Framework WARN: MySQL password not found 2024-04-17T16:10:16,275980Z Framework WARN: Using the same host for MySQL as dirac services 2024-04-17T16:10:16,276059Z Framework WARN: Using port ‘3306’ as MySQL port 2024-04-17T16:10:16,276136Z Framework WARN: Using ‘root’ as root MySQL user 2024-04-17T16:10:16,276325Z Framework WARN: Using the same host for NoSQL as dirac services 2024-04-17T16:10:16,276409Z Framework WARN: Using the default port 9200 2024-04-17T16:10:16,276481Z Framework WARN: NoSQL user not found 2024-04-17T16:10:16,276550Z Framework WARN: NoSQL password not found 2024-04-17T16:10:16,276619Z Framework WARN: NoSQL SSL choice not found
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)
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,
'DestinationSite': 'lpsc-ce.in2p3.fr',
'GridSite': 'LCG.LPSC.fr',
'GridType': 'gLite',
'Jobs': [1848L],
'LastUpdateTime': datetime.datetime(2011, 2, 21, 12, 39, 10),
'VO': 'biomed',
'PilotJobReference': 'https://marlb.in2p3.fr:9000/biq6KT45Q',
'PilotStamp': '',
'Status': 'Done',
'SubmissionTime': datetime.datetime(2011, 2, 21, 12, 27, 52)}}
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,
'DestinationSite': 'cclcgceli01.in2p3.fr',
'GridSite': 'LCG.IN2P3.fr',
'GridType': 'gLite',
'LastUpdateTime': datetime.datetime(2011, 2, 21, 12, 49, 14),
'VO': 'biomed',
'PilotJobReference': 'https://marlb.in2p3.fr:9000/2KHFrQjkw',
'PilotStamp': '',
'Status': 'Done',
'SubmissionTime': datetime.datetime(2011, 2, 21, 12, 27, 52)}}
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-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-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',
'ApplicationStatus': 'Unknown',
'CPUTime': '0.0',
'EndExecTime': '2011-02-14 11:28:01',
'HeartBeatTime': '2011-02-14 11:28:01',
'JobGroup': 'NoGroup',
'JobID': '1',
'JobName': 'DIRAC_vhamar_602138',
'JobType': 'normal',
'LastUpdateTime': '2011-02-14 11:28:11',
'MinorStatus': 'Execution Complete',
'Owner': 'vhamar',
'OwnerGroup': 'eela_user',
'VO': 'dteam',
'RescheduleCounter': '0',
'RescheduleTime': 'None',
'Site': 'EELA.UTFSM.cl',
'StartExecTime': '2011-02-14 11:27:48',
'Status': 'Done',
'SubmissionTime': '2011-02-14 10:12:40',
'UserPriority': '1'}
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',
'Executable': '/bin/ls',
'JobID': '1',
'JobName': 'DIRAC_vhamar_602138',
'JobRequirements': '[OwnerGroup = eela_user;
Setup = EELA-Production;
UserPriority = 1;
CPUTime = 0 ]',
'OutputSandbox': ['std.out', 'std.err'],
'Owner': 'vhamar',
'OwnerGroup': 'eela_user',
'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-jobs-select-output-search
Retrieve output sandbox for DIRAC Jobs for the given selection and search for a string in their std.out
Usage:
dirac-wms-jobs-select-output-search [options] ... String
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
--File= : File name,if not specified default is std.out
Arguments:
String: string to search for
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 /your/lfn/goes/here
$ drm -F myfilecontaininglfns.txt
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,Scouting,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-add-pilot
This command is here mainly to be used by running Pilots. Its goal is to add a PilotReference in PilotAgentsDB, and to update its status.
While SiteDirectors normally add pilots in PilotAgentsDB, the same can’t be true for pilots started in the vacuum (i.e. without SiteDirectors involved). This script is here to solve specifically this issue, even though it can be used for other things too.
Usage:
dirac-admin-add-pilot [options] ... pilotRef VO gridType pilotStamp
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= : sets the pilot status
Arguments:
pilotRef: pilot reference
VO: VO, or pilot owner group
gridType: grid type
pilotStamp: DIRAC pilot stamp
Example:
$ dirac-admin-add-pilot htcondor:123456 dteam DIRAC A11D8D2E-60F8-17A6-5520-E2276F41 --Status=Running
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-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
OwnerGroup: dirac_user
Priority: 1.0
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-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