:orphan: .. this page automatically is created in diracdoctools.cmd.commandReference .. _cmd: ================= Command Reference ================= In this subsection all commands are collected: .. _Accounting_cmd: ---------- Accounting ---------- .. _dirac-accounting-decode-fileid: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-accounting-decode-fileid @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Decode Accounting plot URLs Usage:: dirac-accounting-decode-fileid [options] ... URL [URL] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-accounting-cli @@@@@@@@@@@@@@@@@@@@@@@@@@ Command line administrative interface to DIRAC Accounting DataStore Service Usage:: dirac-admin-accounting-cli [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: ------------- Configuration ------------- .. _dirac-admin-add-resources: @@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-add-resources @@@@@@@@@@@@@@@@@@@@@@@@@ Add resources from the BDII database for a given VO Usage:: dirac-admin-add-resources [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Virtual Organization -D --dry : Dry run -C --ce : Process Computing Elements -H --host : use this url for information querying --onecore : Add Single Core Queues for each MultiCore Queue, set RequiredTag for those Queues .. _dirac-admin-add-shifter: @@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 ] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@ dirac-admin-voms-sync @@@@@@@@@@@@@@@@@@@@@ Synchronize VOMS user data with the DIRAC Registry Usage:: dirac-admin-voms-sync [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : VO name -D --dryRun : Dry run .. _dirac-configuration-cli: @@@@@@@@@@@@@@@@@@@@@@@ dirac-configuration-cli @@@@@@@@@@@@@@@@@@@@@@@ Command line interface to DIRAC Configuration Server Usage:: dirac-configuration-cli [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-configuration-dump-local-cache @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Dump DIRAC Configuration data Usage:: dirac-configuration-dump-local-cache [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Dump Configuration data into -r --raw : Do not make any modification to the data .. _dirac-configuration-shell: @@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: ---- Core ---- .. _dirac-agent: @@@@@@@@@@@ dirac-agent @@@@@@@@@@@ This is a script to launch DIRAC agents. Mostly internal. Usage:: dirac-agent [options] ... Agent [Agent] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Set as DIRAC setup -e --Extensions : Set as DIRAC extensions -C --ConfigurationServer : Set as DIRAC configuration server -I --IncludeAllServers : include all Configuration Servers -n --SiteName : Set as DIRAC Site Name -N --CEName : Determiner from -V --VO : Set the VO name -W --gateway : Configure 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 : Configure /Architecture= -L --LocalSE : Configure LocalSite/LocalSE= -F --ForceUpdate : Force Update of cfg file (i.e. dirac.cfg) (otherwise nothing happens if dirac.cfg already exists) -O --output : 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: @@@@@@@@@@@@@@ dirac-executor @@@@@@@@@@@@@@ This is a script to launch DIRAC executors Usage:: dirac-executor [options] ... executor [executor] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ dirac-generate-cas @@@@@@@@@@@@@@@@@@ Generate a single CA file with all the PEMs Usage:: dirac-generate-cas [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@ dirac-generate-crls @@@@@@@@@@@@@@@@@@@ Generate a single CRLs file Usage:: dirac-generate-crls [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@ dirac-info @@@@@@@@@@ Report info about local DIRAC installation Usage:: dirac-info [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@ dirac-install-db @@@@@@@@@@@@@@@@ Create a new DB in the MySQL server Usage:: dirac-install-db [options] ... DB [DB] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-install-web-portal @@@@@@@@@@@@@@@@@@@@@@@@ Do the initial installation of a DIRAC Web portal Usage:: dirac-install-web-portal [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@ dirac-platform @@@@@@@@@@@@@@ Linux_x86_64_glibc-2.17 .. _dirac-service: @@@@@@@@@@@@@ dirac-service @@@@@@@@@@@@@ This is a script to launch DIRAC services. Mostly internal. Usage:: dirac-service [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@ dirac-version @@@@@@@@@@@@@ usage: dirac_version.py [-h] Print version of current DIRAC installation Usage:: dirac-version [option] Example:: $ dirac-version optional arguments:: -h, --help show this help message and exit .. _install_site.sh: @@@@@@@@@@@@@@@ install_site.sh @@@@@@@@@@@@@@@ Usage:: install_site.sh [Options] ... CFG_file CFG_file - is the name of the installation configuration file which contains all the instructions for the DIRAC installation. See DIRAC Administrator Guide for the details Options:: -d, --debug debug mode -h, --help print this .. _DataManagement_cmd: -------------- DataManagement -------------- .. _dirac-admin-allow-se: @@@@@@@@@@@@@@@@@@@@ dirac-admin-allow-se @@@@@@@@@@@@@@@@@@@@ Enable using one or more Storage Elements Usage:: dirac-admin-allow-se [options] ... seGroupList [seGroupList] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@ dirac-admin-ban-se @@@@@@@@@@@@@@@@@@ Ban one or more Storage Elements for usage Usage:: dirac-admin-ban-se [options] ... seGroupList [seGroupList] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@ 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] ... Catalog [Catalog] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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] ... SE status General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ 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] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : SE for registering archive files at -I --TarballSE : SE to initially upload tarball -P --Path : LFN path to folder, all files in the folder will be archived -N --Name : Name of the Tarball, if not given: Path_Tars/Path_N.tar will be used to store tarballs -L --List : 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 : Where to remove the LFNs from -T --TargetSE : 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : File containing list of LFNs to move -P --Path : LFN path to folder, all files in the folder will be moved -S --SourceSE : Where to remove the LFNs from -T --TargetSE : Where to move the LFNs to -N --Name : 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@ dirac-dms-data-size @@@@@@@@@@@@@@@@@@@ Get the size of the given file or a list of files Usage:: dirac-dms-data-size [options] ... LFN [LFN] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@@@@@@ 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] ... SE General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@@@@@@@ dirac-dms-filecatalog-cli @@@@@@@@@@@@@@@@@@@@@@@@@ Launch the File Catalog shell Usage:: dirac-dms-filecatalog-cli [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Catalog client type to use (default FileCatalog) Example:: $ dirac-dms-filecatalog-cli Starting DIRAC FileCatalog client File Catalog Client $Revision: 1.17 $Date:: FC:/>help Documented commands (type help ):: ======================================== 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: @@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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] ... SE General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@ 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] ... LFN [LFN] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ 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] ... SE [SE] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-dms-replica-metadata @@@@@@@@@@@@@@@@@@@@@@@@@@ Get the given file replica metadata from the File Catalog Usage:: dirac-dms-replica-metadata [options] ... SE General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Catalog to use Arguments:: requestName: a request name LFNs: single LFN or file with LFNs targetSE: target SE .. _dirac-dms-resolve-guid: @@@@@@@@@@@@@@@@@@@@@@ dirac-dms-resolve-guid @@@@@@@@@@@@@@@@@@@@@@ Returns the LFN matching given GUIDs Usage:: dirac-dms-resolve-guid [options] ... GUIDs General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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] ... SE Status General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-dms-show-se-status @@@@@@@@@@@@@@@@@@@@@@@@ Get status of the available Storage Elements Usage:: dirac-dms-show-se-status [] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@ dirac-dms-user-lfns @@@@@@@@@@@@@@@@@@@ Get the list of all the user files. Usage:: dirac-dms-user-lfns [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Match files older than number of days [0] -M --Months : Match files older than number of months [0] -Y --Years : Match files older than number of years [0] -w --Wildcard : Wildcard for matching filenames [All] -b --BaseDir : 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: @@@@@@@@@@@@@@@@@@@@ dirac-dms-user-quota @@@@@@@@@@@@@@@@@@@@ Get the currently defined user data volume quotas Usage:: dirac-dms-user-quota [options] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: --------- Framework --------- .. _dirac-admin-get-CAs: @@@@@@@@@@@@@@@@@@@ dirac-admin-get-CAs @@@@@@@@@@@@@@@@@@@ Refresh the local copy of the CA certificates and revocation lists. Connects to the BundleDelivery service to obtain the tar balls. Needed when proxies appear to be invalid. Usage:: dirac-admin-get-CAs [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@ dirac-admin-get-proxy @@@@@@@@@@@@@@@@@@@@@ Retrieve a delegated proxy for the given user and group Usage:: dirac-admin-get-proxy [options] ... group General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Valid HH:MM for the proxy. By default is 24 hours -l --limited : Get a limited proxy -u --out : File to write as proxy -a --voms : Get proxy with VOMS extension mapped to the DIRAC group -m --vomsAttr : 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-proxy-upload @@@@@@@@@@@@@@@@@@@@@@@@ Upload proxy. Usage:: dirac-admin-proxy-upload [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Valid HH:MM for the proxy. By default is one month -C --Cert : File to use as user certificate -K --Key : File to use as user key -P --Proxy : 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-sysadmin-cli @@@@@@@@@@@@@@@@@@@@@@@@ System administrator client. Usage:: dirac-admin-sysadmin-cli [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-update-pilot @@@@@@@@@@@@@@@@@@@@@@@@ Script to update pilot version in CS Usage:: dirac-admin-update-pilot [options] ... version General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Location of pilot version in CS /Operations//Pilot/Version (default value specified in CS under /DIRAC/DefaultSetup) Arguments:: version: pilot version you want to update to .. _dirac-admin-users-with-proxy: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-users-with-proxy @@@@@@@@@@@@@@@@@@@@@@@@@@@@ Print list of users with proxies. Usage:: dirac-admin-users-with-proxy [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Required HH:MM for the users Example:: $ dirac-admin-users-with-proxy * vhamar DN : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar group : dirac_admin not after : 2011-06-29 12:04:25 persistent : False - DN : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar group : dirac_pilot not after : 2011-06-29 12:04:27 persistent : False - DN : /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar group : dirac_user not after : 2011-06-29 12:04:30 persistent : True .. _dirac-install-component: @@@@@@@@@@@@@@@@@@@@@@@ dirac-install-component @@@@@@@@@@@@@@@@@@@@@@@ 2022-10-26 16:05:21 UTC Framework ALWAYS: Can't load /srv/localstage/scratch/dbauer/diracdev_comdirac/diracos/envs/docs/etc/dirac.cfg 2022-10-26 16:05:21 UTC Framework ALWAYS: Might be OK if setting up the site Do the initial installation and configuration of a DIRAC component Usage:: dirac-install-component [options] ... Component General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Python module name for the component code -p --parameter : Special component option Arguments:: System/Component: Full component name (ie: WorkloadManagement/Matcher) System: Name of the DIRAC system (ie: WorkloadManagement) Component: Name of the DIRAC service (ie: Matcher) (optional) .. _dirac-install-tornado-service: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-install-tornado-service @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 2022-10-26 16:05:21 UTC Framework ALWAYS: Can't load /srv/localstage/scratch/dbauer/diracdev_comdirac/diracos/envs/docs/etc/dirac.cfg 2022-10-26 16:05:21 UTC Framework ALWAYS: Might be OK if setting up the site Do the initial installation and configuration of a DIRAC service based on tornado Usage:: dirac-install-tornado-service [options] ... Component General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Python module name for the component code -p --parameter : Special component option Arguments:: System/Component: Full component name (ie: WorkloadManagement/Matcher) System: Name of the DIRAC system (ie: WorkloadManagement) Component: Name of the DIRAC service (ie: Matcher) (optional) .. _dirac-login: @@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : set access lifetime in hours -O --out : where to save the authorization result(e.g: proxy or tokens). By default we will try to find a standard place. -I --issuer : 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 : user certificate location -K --key : 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: @@@@@@@@@@@@ dirac-logout @@@@@@@@@@@@ Logout Usage:: dirac-logout [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : set issuer -F --file : set target file location Example:: $ dirac-logout .. _dirac-myproxy-upload: @@@@@@@@@@@@@@@@@@@@ dirac-myproxy-upload @@@@@@@@@@@@@@@@@@@@ Usage:: dirac-myproxy-upload [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : File to use as proxy -D --DN : Use DN as myproxy username .. _dirac-populate-component-db: @@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Comma separated list of hosts to be excluded from the scanning process .. _dirac-proxy-destroy: @@@@@@@@@@@@@@@@@@@ dirac-proxy-destroy @@@@@@@@@@@@@@@@@@@ Command line tool to remove local and remote proxies Usage:: dirac-proxy-destroy [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Delete uploaded proxy for vo name given Example:: $ dirac-proxy-destroy -a .. _dirac-proxy-get-uploaded-info: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-proxy-get-uploaded-info @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Print information about uploaded proxies. Usage:: dirac-proxy-get-uploaded-info [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : User to query (by default oneself) Example:: $ dirac-proxy-get-uploaded-info Checking for DNs /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar -------------------------------------------------------------------------------------------------------- | UserDN | UserGroup | ExpirationTime | PersistentFlag | -------------------------------------------------------------------------------------------------------- | /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar | dirac_user | 2011-06-29 12:04:25 | True | -------------------------------------------------------------------------------------------------------- .. _dirac-proxy-info: @@@@@@@@@@@@@@@@ dirac-proxy-info @@@@@@@@@@@@@@@@ Print information about the current proxy. Usage:: dirac-proxy-info [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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 -j --noclockcheck : Disable checking if time is ok -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: @@@@@@@@@@@@@@@@ dirac-proxy-init @@@@@@@@@@@@@@@@ Creating a proxy. Usage:: dirac-proxy-init [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Valid HH:MM for the proxy. By default is 24 hours -g --group : DIRAC Group to embed in the proxy -b --strength : 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 : File to use as user certificate -K --Key : File to use as user key -u --out : File to write as proxy -x --nocs : Disable CS check -p --pwstdin : Get passwd from stdin -j --noclockcheck : Disable checking if time is ok -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: @@@@@@@@@@@@@@@@@@@@@@@ dirac-restart-component @@@@@@@@@@@@@@@@@@@@@@@ Restart DIRAC component using runsvctrl utility Usage:: dirac-restart-component [options] ... System General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@ dirac-start-component @@@@@@@@@@@@@@@@@@@@@ Start DIRAC component using runsvctrl utility Usage:: dirac-start-component [options] ... System General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@ dirac-status-component @@@@@@@@@@@@@@@@@@@@@@ Status of DIRAC components using runsvstat utility Usage:: dirac-status-component [options] ... System General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@ dirac-stop-component @@@@@@@@@@@@@@@@@@@@ Stop DIRAC component using runsvctrl utility Usage:: dirac-stop-component [options] ... System General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ dirac-sys-sendmail @@@@@@@@@@@@@@@@@@ Utility to send an e-mail using DIRAC notification service. Usage:: dirac-sys-sendmail [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ dirac-uninstall-component @@@@@@@@@@@@@@@@@@@@@@@@@ 2022-10-26 16:05:21 UTC Framework ALWAYS: Can't load /srv/localstage/scratch/dbauer/diracdev_comdirac/diracos/envs/docs/etc/dirac.cfg 2022-10-26 16:05:21 UTC Framework ALWAYS: Might be OK if setting up the site Uninstallation of a DIRAC component Usage:: dirac-uninstall-component [options] ... Component General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: ---------- Interfaces ---------- .. _dcd: @@@ dcd @@@ Change current DIRAC File Catalog working directory Examples:: $ dcd /dirac/user $ dcd Usage:: dcd [options] ... Path General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@ dchgrp @@@@@@ Change file owner's group Examples:: $ dchown atsareg ././some_lfn_file $ dchown -R pgay ./ Usage:: dchgrp [options] ... group Path [Path] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@ dchmod @@@@@@ Change file mode bits Examples:: $ dchmod 755 ././some_lfn_file $ dchmod -R 700 ./ Usage:: dchmod [options] ... mode Path [Path] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@ dchown @@@@@@ Change file owner Examples:: $ dchown atsareg ././some_lfn_file $ dchown -R pgay ./ Usage:: dchown [options] ... owner Path [Path] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@ dconfig @@@@@@@ configure DCommands Usage:: dconfig [options] ... section[.option[=value]] [section[.option[=value]]] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@ dfind @@@@@ find files in the FileCatalog Examples:: $ dfind . "some_integer_metadata>1" Usage:: dfind [options] ... lfn metaspec [metaspec] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@ dgetenv @@@@@@@ print DCommands session environment variables Usage:: dgetenv [options] ... [section.]option General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: [section.]option: section: display all options in section section.option: display section specific option (optional) .. _dinit: @@@@@ dinit @@@@@ initialize DCommands session Usage:: dinit [options] ... profile name General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Options:: -p --fromProxy : build session from existing proxy -D --destroy : destroy session information Arguments:: profile name: existing profile section in DCommands config (optional) .. _dinput: @@@@@@ dinput @@@@@@ Retrieve input sandbox for a DIRAC job Usage:: dinput [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : destination directory -j --JDL : download job JDL instead of input sandbox --Sandbox : donwload input sandbox, even if JDL was required -v --verbose : verbose output -g --JobGroup : Get output for jobs in the given group -i --input-file : read JobIDs from file Arguments:: JobID: DIRAC Job ID (optional) .. _dirac-admin-add-group: @@@@@@@@@@@@@@@@@@@@@ dirac-admin-add-group @@@@@@@@@@@@@@@@@@@@@ Add or Modify a Group info in DIRAC Usage:: dirac-admin-add-group [options] ... Property= [Property=] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Name of the Group (Mandatory) -U --UserName : Short Name of user to be added to the Group (Allow Multiple instances or None) -P --Property : Property to be added to the Group (Allow Multiple instances or None) Arguments:: Property=: Other properties to be added to the Group like (VOMSRole=XXXX) (optional) Example:: $ dirac-admin-add-group -G dirac_test .. _dirac-admin-add-host: @@@@@@@@@@@@@@@@@@@@ dirac-admin-add-host @@@@@@@@@@@@@@@@@@@@ Add or Modify a Host info in DIRAC Usage:: dirac-admin-add-host [options] ... Property= [Property=] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Name of the Host (Mandatory) -D --HostDN : DN of the Host Certificate (Mandatory) -P --Property : Property to be added to the Host (Allow Multiple instances or None) Arguments:: Property=: 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: @@@@@@@@@@@@@@@@@@@@ dirac-admin-add-user @@@@@@@@@@@@@@@@@@@@ Add or Modify a User info in DIRAC Usage:: dirac-admin-add-user [options] ... Property= [Property=] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Short Name of the User (Mandatory) -D --UserDN : DN of the User Certificate (Mandatory) -M --UserMail : eMail of the user (Mandatory) -G --UserGroup : Name of the Group for the User (Allow Multiple instances or None) Arguments:: Property=: 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: @@@@@@@@@@@@@@@@@@@@@@ dirac-admin-allow-site @@@@@@@@@@@@@@@@@@@@@@ Add Site to Active mask for current Setup Usage:: dirac-admin-allow-site [options] ... Site Comment General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@@ dirac-admin-ban-site @@@@@@@@@@@@@@@@@@@@ Remove Site from Active mask for current Setup Usage:: dirac-admin-ban-site [options] ... Site Comment General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@ dirac-admin-ce-info @@@@@@@@@@@@@@@@@@@ Retrieve Site Associated to a given CE Usage:: dirac-admin-ce-info [options] ... CE General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-delete-user @@@@@@@@@@@@@@@@@@@@@@@ Remove User from Configuration Usage:: dirac-admin-delete-user [options] ... User [User] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-get-banned-sites @@@@@@@@@@@@@@@@@@@@@@@@@@@@ Get banned sites Usage:: dirac-admin-get-banned-sites [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: JobID: DIRAC ID of the Job Example:: $ dirac-admin-get-job-pilots 1848 {'https://marlb.in2p3.fr:9000/bqYViq6KrVgGfr6wwgT45Q': {'AccountingSent': 'False', 'BenchMark': 8.1799999999999997, 'Broker': 'marwms.in2p3.fr', 'DestinationSite': 'lpsc-ce.in2p3.fr', 'GridSite': 'LCG.LPSC.fr', 'GridType': 'gLite', 'Jobs': [1848L], 'LastUpdateTime': datetime.datetime(2011, 2, 21, 12, 39, 10), 'OutputReady': 'True', 'OwnerDN': '/O=GRID/C=FR/O=CNRS/OU=LPC/CN=Sebastien Guizard', 'OwnerGroup': '/biomed', 'ParentID': 0L, 'PilotID': 2247L, 'PilotJobReference': 'https://marlb.in2p3.fr:9000/biq6KT45Q', 'PilotStamp': '', 'Status': 'Done', 'SubmissionTime': datetime.datetime(2011, 2, 21, 12, 27, 52), 'TaskQueueID': 399L}} .. _dirac-admin-get-pilot-info: @@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-get-pilot-info @@@@@@@@@@@@@@@@@@@@@@@@@@ Retrieve available info about the given pilot Usage:: dirac-admin-get-pilot-info [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Options:: -e --extended : Get extended printout Example:: $ dirac-admin-get-pilot-info https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw {'https://marlb.in2p3.fr:9000/26KCLKBFtxXKHF4_ZrQjkw': {'AccountingSent': 'False', 'BenchMark': 0.0, 'Broker': 'marwms.in2p3.fr', 'DestinationSite': 'cclcgceli01.in2p3.fr', 'GridSite': 'LCG.IN2P3.fr', 'GridType': 'gLite', 'LastUpdateTime': datetime.datetime(2011, 2, 21, 12, 49, 14), 'OutputReady': 'False', 'OwnerDN': '/O=GRID/C=FR/O=CNRS/OU=LPC/CN=Sebastien Guizard', 'OwnerGroup': '/biomed', 'ParentID': 0L, 'PilotID': 2241L, 'PilotJobReference': 'https://marlb.in2p3.fr:9000/2KHFrQjkw', 'PilotStamp': '', 'Status': 'Done', 'SubmissionTime': datetime.datetime(2011, 2, 21, 12, 27, 52), 'TaskQueueID': 399L}} .. _dirac-admin-get-pilot-logging-info: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-get-pilot-output @@@@@@@@@@@@@@@@@@@@@@@@@@@@ Retrieve output of a Grid pilot Usage:: dirac-admin-get-pilot-output [options] ... PilotID [PilotID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@ dirac-admin-list-hosts @@@@@@@@@@@@@@@@@@@@@@ List hosts Usage:: dirac-admin-list-hosts [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-modify-user @@@@@@@@@@@@@@@@@@@@@@@ Modify a user in the CS. Usage:: dirac-admin-modify-user [options] ... user DN group [group] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Add property to the user = -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: @@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-pilot-summary @@@@@@@@@@@@@@@@@@@@@@@@@ Pilot summary Usage:: dirac-admin-pilot-summary [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-service-ports @@@@@@@@@@@@@@@@@@@@@@@@@ Print the service ports for the specified setup Usage:: dirac-admin-service-ports [options] ... Setup General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@ dirac-admin-site-info @@@@@@@@@@@@@@@@@@@@@ Print Configuration information for a given Site Usage:: dirac-admin-site-info [options] ... Site [Site] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-site-mask-logging @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Retrieves site mask logging information. Usage:: dirac-admin-site-mask-logging [options] ... Site [Site] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@ dirac-dms-lfn-metadata @@@@@@@@@@@@@@@@@@@@@@ Obtain replica metadata from file catalogue client. Usage:: dirac-dms-lfn-metadata [options] ... LFN [LFN] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@ dirac-dms-lfn-replicas @@@@@@@@@@@@@@@@@@@@@@ Obtain replica information from file catalogue client. Usage:: dirac-dms-lfn-replicas [options] ... LFN [LFN] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-framework-ping-service @@@@@@@@@@@@@@@@@@@@@@@@@@@@ Ping the given DIRAC Service Usage:: dirac-framework-ping-service [options] ... Service General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ 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 ""/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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help .. _dirac-repo-monitor: @@@@@@@@@@@@@@@@@@ dirac-repo-monitor @@@@@@@@@@@@@@@@@@ Monitor the jobs present in the repository Usage:: dirac-repo-monitor [options] ... RepoDir General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: RepoDir: Location of Job Repository .. _dirac-utils-file-adler: @@@@@@@@@@@@@@@@@@@@@@ dirac-utils-file-adler @@@@@@@@@@@@@@@@@@@@@@ Calculate alder32 of the supplied file Usage:: dirac-utils-file-adler [options] ... File [File] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@ dirac-utils-file-md5 @@@@@@@@@@@@@@@@@@@@ Calculate md5 of the supplied file Usage:: dirac-utils-file-md5 [options] ... File [File] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: File: File Name Example:: $ dirac-utils-file-md5 Example.tgz Example.tgz 5C1A1102-EAFD-2CBA-25BD-0EFCCFC3623E .. _dirac-wms-get-normalized-queue-length: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-wms-get-normalized-queue-length @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Report Normalized CPU length of queue This script was used by the dirac-pilot script to set the CPUTime limit for the matching but now this is no more the case. Usage:: dirac-wms-get-normalized-queue-length [options] ... Queue [Queue] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: Queue: GlueCEUniqueID of the Queue (ie, juk.nikhef.nl:8443/cream-pbs-lhcb) Example:: $ dirac-wms-get-normalized-queue-length cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long 857400.0 .. _dirac-wms-get-queue-normalization: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-wms-get-queue-normalization @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Report Normalization Factor applied by Site to the given Queue Usage:: dirac-wms-get-queue-normalization [options] ... Queue [Queue] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: Queue: GlueCEUniqueID of the Queue (ie, juk.nikhef.nl:8443/cream-pbs-lhcb) Example:: $ dirac-wms-get-queue-normalization cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long cclcgceli03.in2p3.fr:2119/jobmanager-bqs-long 2500.0 .. _dirac-wms-job-attributes: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-wms-job-attributes @@@@@@@@@@@@@@@@@@@@@@@@ Retrieve attributes associated with the given DIRAC job Usage:: dirac-wms-job-attributes [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: JobID: DIRAC Job ID Example:: $ dirac-wms-job-attributes 1 {'AccountedFlag': 'False', 'ApplicationNumStatus': '0', 'ApplicationStatus': 'Unknown', 'CPUTime': '0.0', 'DIRACSetup': 'EELA-Production', 'DeletedFlag': 'False', 'EndExecTime': '2011-02-14 11:28:01', 'FailedFlag': 'False', 'HeartBeatTime': '2011-02-14 11:28:01', 'ISandboxReadyFlag': 'False', 'JobGroup': 'NoGroup', 'JobID': '1', 'JobName': 'DIRAC_vhamar_602138', 'JobSplitType': 'Single', 'JobType': 'normal', 'KilledFlag': 'False', 'LastUpdateTime': '2011-02-14 11:28:11', 'MasterJobID': '0', 'MinorStatus': 'Execution Complete', 'OSandboxReadyFlag': 'False', 'Owner': 'vhamar', 'OwnerDN': '/O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar', 'OwnerGroup': 'eela_user', 'RescheduleCounter': '0', 'RescheduleTime': 'None', 'RetrievedFlag': 'False', 'RunNumber': '0', 'Site': 'EELA.UTFSM.cl', 'StartExecTime': '2011-02-14 11:27:48', 'Status': 'Done', 'SubmissionTime': '2011-02-14 10:12:40', 'SystemPriority': '0', 'UserPriority': '1', 'VerifiedFlag': 'True'} .. _dirac-wms-job-delete: @@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Get output for jobs with IDs from the file -g --JobGroup : 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: @@@@@@@@@@@@@@@@@@@@@@@ dirac-wms-job-get-input @@@@@@@@@@@@@@@@@@@@@@@ Retrieve input sandbox for DIRAC Job Usage:: dirac-wms-job-get-input [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Options:: -O --Original : Gets the original JDL Arguments:: JobID: DIRAC Job ID Example:: $ dirac-wms-job-get-jdl 1 {'Arguments': '-ltrA', 'CPUTime': '86400', 'DIRACSetup': 'EELA-Production', 'Executable': '/bin/ls', 'JobID': '1', 'JobName': 'DIRAC_vhamar_602138', 'JobRequirements': '[OwnerDN = /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar; OwnerGroup = eela_user; Setup = EELA-Production; UserPriority = 1; CPUTime = 0 ]', 'OutputSandbox': ['std.out', 'std.err'], 'Owner': 'vhamar', 'OwnerDN': '/O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar', 'OwnerGroup': 'eela_user', 'OwnerName': 'vhamar', 'Priority': '1'} .. _dirac-wms-job-get-output: @@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Store the output in this directory -f --File : Get output for jobs with IDs from the file -g --JobGroup : 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Store the output in this directory Arguments:: JobID: DIRAC Job ID .. _dirac-wms-job-kill: @@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-wms-job-parameters @@@@@@@@@@@@@@@@@@@@@@@@ Retrieve parameters associated to the given DIRAC job Usage:: dirac-wms-job-parameters [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ dirac-wms-job-peek @@@@@@@@@@@@@@@@@@ Peek StdOut of the given DIRAC job Usage:: dirac-wms-job-peek [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-wms-job-reschedule @@@@@@@@@@@@@@@@@@@@@@@@ Reschedule the given DIRAC job Usage:: dirac-wms-job-reschedule [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@ dirac-wms-job-status @@@@@@@@@@@@@@@@@@@@ Retrieve status of the given DIRAC job Usage:: dirac-wms-job-status [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Get status for jobs with IDs from the file -g --JobGroup : 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: @@@@@@@@@@@@@@@@@@@@ dirac-wms-job-submit @@@@@@@@@@@@@@@@@@@@ Submit jobs to DIRAC WMS Usage:: dirac-wms-job-submit [options] ... JDL [JDL] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Writes job ids to file -r --UseJobRepo : 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@ dirac-wms-select-jobs @@@@@@@@@@@@@@@@@@@@@ Select DIRAC jobs matching the given conditions Usage:: dirac-wms-select-jobs [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@ dkill @@@@@ Kill or delete DIRAC job Usage:: dkill [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@ dlogging @@@@@@@@ Retrieve logging information for a DIRAC job Usage:: dlogging [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : display format (pretty, csv, json) Arguments:: JobID: DIRAC Job ID .. _dls: @@@ dls @@@ list FileCatalog file or directory Examples:: $ dls $ dls .. $ dls / Usage:: dls [options] ... Path [Path] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@ dmeta @@@@@ manipulate metadata in the FileCatalog Usage:: dmeta -I - list metadata indices ++ OR ++ dmeta -i r meta... - delete metadata index General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : set or remove metadata indices -I --list-index : list defined metadata indices Arguments:: meta: metadata index to be deleted ++ OR ++ dmeta -i f|d meta=(int|float|string|date) add metadata index for files or directories .. _dmkdir: @@@@@@ dmkdir @@@@@@ create a directory in the FileCatalog Examples:: $ dmkdir ./some_lfn_dir Usage:: dmkdir [options] ... Path [Path] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@ doutput @@@@@@@ Retrieve output sandbox for a DIRAC job Usage:: doutput [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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 : Get output for jobs in the given group -i --input-file : read JobIDs from file Arguments:: JobID: DIRAC Job ID (optional) .. _dput: @@@@ dput @@@@ Uploads a file to an SE and registers it in the file catalog. Usage:: dput [options] local_path[... lfn] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : 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: @@@@ dpwd @@@@ print DCommands working directory Usage:: dpwd [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Storage Element where to put replica (or a comma separated list) -S --source-se : source Storage Element for replication Arguments:: lfn: file entry in the FileCatalog .. _dreplicas: @@@@@@@@@ dreplicas @@@@@@@@@ Print list replicas for files in the FileCatalog Usage:: dreplicas [options] ... lfn [lfn] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@ drm @@@ Remove files from the FileCatalog (and all replicas from Storage Elements) Examples:: $ drm ./some_lfn_file Usage:: drm [options] ... lfn [lfn] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : file containing a list of LFNs -D --destination-se : Storage Element from where to remove replica -r -- : remove directory recursively Arguments:: lfn: logical file name (optional) .. _drmdir: @@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 .. _dsetenv: @@@@@@@ dsetenv @@@@@@@ register DCommands session environment variables Usage:: dsetenv [options] ... [section.]option=value General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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=value: section: section (defaults to "session:environment") option: option name value: value to be set (optional) .. _dsize: @@@@@ dsize @@@@@ print FileCatalog file or directory disk usage Usage:: dsize [options] [path] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@ dstat @@@@@ Retrieves job status according to given criteria. Example:: $ dstat -a -u your.dirac.username Usage:: dstat [options] ... JobID [JobID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : job owner -S --Status : select job by status (comma separated list of statuses in: Submitting,Received,Checking,Staging,Waiting,Matched,Rescheduled,Running,Stalled,Completing,Done,Completed,Failed,Deleted,Killed) -a --StatusAll : display jobs of any status -g --JobGroup : select job by job group -n --JobName : select job by job name -f --Fmt : display format (pretty, csv, json) -D --JobDate : age of jobs to display (in days) -F --Fields : 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 : read JobIDs from file Arguments:: JobID: DIRAC Job ID (optional) Example:: $ dstat -a -u your.dirac.username .. _dsub: @@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : JDL file or inline -N --JobName : job name -E --StdError : job standard error file -O --StdOutput : 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:[:[:]]) --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) .. _dunsetenv: @@@@@@@@@ dunsetenv @@@@@@@@@ Remove DCommands session environment variables Usage:: dunsetenv [options] ... [section.]option=value General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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=value: section: section (defaults to "session:environment") option: option name (optional) .. _Production_cmd: ---------- Production ---------- .. _dirac-prod-add-trans: @@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@ dirac-prod-clean @@@@@@@@@@@@@@@@ Clean a given production Usage:: dirac-prod-clean [options] ... prodID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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-delete: @@@@@@@@@@@@@@@@@ dirac-prod-delete @@@@@@@@@@@@@@@@@ Delete a given production Usage:: dirac-prod-delete [options] ... prodID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@ dirac-prod-get @@@@@@@@@@@@@@ Get informations for a given production Usage:: dirac-prod-get [options] ... prodID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ dirac-prod-get-all @@@@@@@@@@@@@@@@@@ Get summary informations of all productions Usage:: dirac-prod-get-all [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-prod-get-description @@@@@@@@@@@@@@@@@@@@@@@@@@ Get the description of a given production Usage:: dirac-prod-get-description [options] ... prodID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@ dirac-prod-get-trans @@@@@@@@@@@@@@@@@@@@ Get the transformations belonging to a given production Usage:: dirac-prod-get-trans [options] ... prodID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@ dirac-prod-start @@@@@@@@@@@@@@@@ Start a given production Usage:: dirac-prod-start [options] ... prodID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@ dirac-prod-stop @@@@@@@@@@@@@@@ Stop a given production Usage:: dirac-prod-stop [options] ... prodID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: ----------------- RequestManagement ----------------- .. _dirac-rms-list-req-cache: @@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ dirac-rms-reqdb-summary @@@@@@@@@@@@@@@@@@@@@@@ Show ReqDB summary Usage:: dirac-rms-reqdb-summary [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@ dirac-rms-request @@@@@@@@@@@@@@@@@ Show request given its ID, a jobID or a transformation and a task Usage:: dirac-rms-request [options] ... request [request] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: -------------- ResourceStatus -------------- .. _dirac-rss-list-status: @@@@@@@@@@@@@@@@@@@@@ dirac-rss-list-status @@@@@@@@@@@@@@@@@@@@@ DIRAC 0.1.dev35588+geb9bce5 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@ dirac-rss-query-db @@@@@@@@@@@@@@@@@@ DIRAC version: 0.1.dev35588+geb9bce5 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ dirac-rss-query-dtcache @@@@@@@@@@@@@@@@@@@@@@@ DIRAC version: 0.1.dev35588+geb9bce5 Select/Add/Delete a new DownTime entry for a given Site or Service. Usage:: dirac-rss-query-dtcache [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@ dirac-rss-set-status @@@@@@@@@@@@@@@@@@@@ DIRAC 0.1.dev35588+geb9bce5 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@ dirac-rss-set-token @@@@@@@@@@@@@@@@@@@ DIRAC 0.1.dev35588+geb9bce5 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@ dirac-rss-sync @@@@@@@@@@@@@@ DIRAC 0.1.dev35588+geb9bce5 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: --------- Resources --------- .. _dirac-resource-get-parameters: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-resource-get-parameters @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Get parameters assigned to the CE Usage:: dirac-resource-get-parameters [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Computing Element Name (Mandatory) -S --Site : Site Name (Mandatory) -Q --Queue : Queue Name (Mandatory) .. _dirac-resource-info: @@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Get resources for the given VO. If not set, taken from the proxy .. _StorageManagement_cmd: ----------------- StorageManagement ----------------- .. _dirac-stager-monitor-file: @@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@ 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 General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 to Stage (or local file with list of LFNs) : 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 $ 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 .. _Transformation_cmd: -------------- Transformation -------------- .. _dirac-production-runjoblocal: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Set jobID here. Defines data acquisition as DownloadInputData -I --Protocol : Set jobID here. Defines data acquisition as InputDataByProtocol .. _dirac-transformation-add-files: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-add-files @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Add files to an existing transformation Usage:: dirac-transformation-add-files [options] ... TransID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-archive @@@@@@@@@@@@@@@@@@@@@@@@@@@@ Archive a transformation Usage:: dirac-transformation-archive [options] ... transID [transID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-clean @@@@@@@@@@@@@@@@@@@@@@@@@@ Clean a tranformation Usage:: dirac-transformation-clean [options] ... transID [transID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-cli @@@@@@@@@@@@@@@@@@@@@@@@ Command to launch the Transformation Shell Usage:: dirac-transformation-cli [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-get-files @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Get the files attached to a transformation Usage:: dirac-transformation-get-files [options] ... transID General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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-recover-data: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-recover-data @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Script to call the DataRecoveryAgent functionality by hand. Usage:: dirac-transformation-recover-data [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : TransID to Check/Fix -X --Enabled : Enable the changes .. _dirac-transformation-remove-output: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-remove-output @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Remove the outputs produced by a transformation Usage:: dirac-transformation-remove-output [options] ... transID [transID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 [-G] [-S][-N] [-T] [-M] [-K...] -x General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Number of Files per transformation task -R --GroupName : TransformationGroup Name -S --SourceSEs : SourceSE(s) to use, comma separated list -N --Extraname : String to append to transformation name -P --Plugin : Plugin to use for transformation -T --Flavour : Flavour to create: Replication or Moving -K --MetaKey : Meta Key to use: TransformationID -M --MetaData : MetaData to use Key/Value Pairs: 'DataType:REC,' -x --Enable : Enable the transformation creation, otherwise dry-run .. _dirac-transformation-verify-outputdata: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-transformation-verify-outputdata @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Runs checkTransformationIntegrity from ValidateOutputDataAgent on selected Tranformation Usage:: dirac-transformation-verify-outputdata [options] ... transID [transID] General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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_cmd: ------------------ WorkloadManagement ------------------ .. _dirac-admin-kill-pilot: @@@@@@@@@@@@@@@@@@@@@@ dirac-admin-kill-pilot @@@@@@@@@@@@@@@@@@@@@@ Kill the specified pilot Usage:: dirac-admin-kill-pilot [options] ... PilotRef General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: PilotRef: pilot reference .. _dirac-admin-pilot-logging-info: @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-pilot-logging-info @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Get Pilots Logging for specific Pilot UUID or Job ID. WARNING: Only one option (either uuid or jobid) should be used. Usage:: dirac-admin-pilot-logging-info [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Options:: -u --uuid : get PilotsLogging for given Pilot UUID -j --jobid : get PilotsLogging for given Job ID .. _dirac-admin-show-task-queues: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ dirac-admin-show-task-queues @@@@@@@@@@@@@@@@@@@@@@@@@@@@ Show details of currently active Task Queues Usage:: dirac-admin-show-task-queues [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : show this task queue only Example:: $ dirac-admin-show-task-queues Getting TQs.. * TQ 401 CPUTime: 360 Jobs: 3 OwnerDN: /O=GRID-FR/C=FR/O=CNRS/OU=CPPM/CN=Vanessa Hamar OwnerGroup: dirac_user Priority: 1.0 Setup: Dirac-Production .. _dirac-admin-sync-pilot: @@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Parameters that are passed directly to the workflow Arguments:: jobXMLfile: specify path to the Job XML file description .. _dirac-vm-cli: @@@@@@@@@@@@ dirac-vm-cli @@@@@@@@@@@@ Usage:: dirac-vm-cli [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help .. _dirac-vm-endpoint-status: @@@@@@@@@@@@@@@@@@@@@@@@ dirac-vm-endpoint-status @@@@@@@@@@@@@@@@@@@@@@@@ Get VM instances available in the configured cloud sites Usage:: dirac-vm-endpoint-status [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Options:: -S --Site : Site Name -C --CE : Cloud Endpoint Name -I --Image : Image Name -v --vo : VO name .. _dirac-vm-get-pilot-output: @@@@@@@@@@@@@@@@@@@@@@@@@ dirac-vm-get-pilot-output @@@@@@@@@@@@@@@@@@@@@@@@@ Get pilot output from a VM Usage:: dirac-vm-get-pilot-output [options] ... pilotRef General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: pilotRef: pilot reference .. _dirac-vm-instance-stop: @@@@@@@@@@@@@@@@@@@@@@ dirac-vm-instance-stop @@@@@@@@@@@@@@@@@@@@@@ Get VM instances available in the configured cloud sites Usage:: dirac-vm-instance-stop [options] ... site CE node General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load additional config file --autoreload : Automatically restart if there's any change in the module --license : Show DIRAC's LICENSE -h --help : Shows this help Arguments:: site: Site name CE: Cloud Endpoint Name node: node name .. _dirac-wms-cpu-normalization: @@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Run n parallel copies of the benchmark -U --Update : Update dirac.cfg with the resulting value -R --Reconfig : Update given configuration file with the resulting value .. _dirac-wms-get-queue-cpu-time: @@@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : CPUNormalizationFactor, in case it is known .. _dirac-wms-get-wn: @@@@@@@@@@@@@@@@ dirac-wms-get-wn @@@@@@@@@@@@@@@@ Get WNs for a selection of jobs Usage:: dirac-wms-get-wn [options] ... General options:: -o --option : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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: @@@@@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Computing Element Name (Mandatory) -S --Site : Site Name (Mandatory) -Q --Queue : Queue Name (Mandatory) .. _dirac-wms-match: @@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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 : Check matching for these sites (comma separated list) Arguments:: job_JDL: file with job JDL description .. _dirac-wms-pilot-job-info: @@@@@@@@@@@@@@@@@@@@@@@@ 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 : Option=value to add -s --section : Set base section for relative parsed options -c --cert : Use server certificate to connect to Core Services -d --debug : Set debug mode (-ddd is extra debug) --cfg= : Load 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