ARC Control Tool¶

Nordugrid ARC Computing Element Control Tool

usage: arcctl [-h] [-c CONFIG] [-d {CRITICAL,ERROR,WARNING,INFO,DEBUG}]
              COMPONENT ...

Named Arguments¶

-c, --config

config file location (default is “/etc/arc.conf”)

Default: “/etc/arc.conf”

-d, --debug

Possible choices: CRITICAL, ERROR, WARNING, INFO, DEBUG

verbosity level (default is “WARNING”)

Default: “WARNING”

ARC CE Components¶

COMPONENT

Possible choices: rte, job, service, deploy, accounting

Controlling RunTimeEnvironemtns¶

usage: arcctl rte [-h] ACTION ...

RunTime Environments Actions¶

ACTION

Possible choices: enable, disable, list, default, undefault, cat, params-get, params-set

DESCRIPTION

Sub-commands:¶

enable¶

Enable RTE to be used by A-REX

arcctl rte enable [-h] [-f] rte [rte ...]

Positional Arguments¶

rte

RTE name

Named Arguments¶

-f, --force

Force RTE enabling

Default: False

disable¶

Disable RTE to be used by A-REX

arcctl rte disable [-h] rte [rte ...]

Positional Arguments¶

rte

RTE name

list¶

List RunTime Environments

arcctl rte list [-h] [-l] [-e | -d | -a | -s | -u]

Named Arguments¶

`-l, --long`	Detailed listing of RTEs Default: False
`-e, --enabled`	List enabled RTEs Default: False
`-d, --default`	List default RTEs Default: False
`-a, --available`
	List available RTEs Default: False
`-s, --system`	List available system RTEs Default: False
`-u, --user`	List available user-defined RTEs Default: False

default¶

Transparently use RTE for every A-REX job

arcctl rte default [-h] [-f] rte [rte ...]

Positional Arguments¶

rte

RTE name

Named Arguments¶

-f, --force

Force RTE enabling

Default: False

undefault¶

Remove RTE from transparent A-REX usage

arcctl rte undefault [-h] rte [rte ...]

Positional Arguments¶

rte

RTE name

cat¶

Print the content of RTE file

arcctl rte cat [-h] rte

Positional Arguments¶

rte

RTE name

params-get¶

List configurable RTE parameters

arcctl rte params-get [-h] [-l] rte

Positional Arguments¶

rte

RTE name

Named Arguments¶

-l, --long

Detailed listing of parameters

Default: False

params-set¶

Set configurable RTE parameters

arcctl rte params-set [-h] rte parameter value

Positional Arguments¶

`rte`	RTE name
`parameter`	RTE parameter to configure
`value`	RTE parameter value to set

Controlling A-REX Jobs¶

usage: arcctl job [-h] [-t CACHETTL] ACTION ...

Named Arguments¶

-t, --cachettl

GM-Jobs output caching validity in seconds (default is 30)

Default: 30

Jobs Control Actions¶

ACTION

Possible choices: list, log, info, attr, kill, killall, clean, cleanall, stats

DESCRIPTION

Sub-commands:¶

list¶

List available A-REX jobs

arcctl job list [-h] [-l]
                [-s {ACCEPTED,PREPARING,SUBMIT,INLRMS,FINISHING,FINISHED,DELETED,CANCELING}]
                [-o OWNER]

Named Arguments¶

-l, --long

Detailed listing of jobs

Default: False

-s, --state

Possible choices: ACCEPTED, PREPARING, SUBMIT, INLRMS, FINISHING, FINISHED, DELETED, CANCELING

Filter jobs by state

-o, --owner

Filter jobs by owner

log¶

Display job log

arcctl job log [-h] [-l] [-s] jobid

Positional Arguments¶

jobid

Job ID

Named Arguments¶

-l, --lrms

Include LRMS job submission script into the output

Default: False

-s, --service

Show ARC CE logs containing the jobID instead of job log

Default: False

info¶

Show job main info

arcctl job info [-h] jobid

Positional Arguments¶

jobid

Job ID

attr¶

Get

arcctl job attr [-h] jobid [attr]

Positional Arguments¶

`jobid`	Job ID
`attr`	Attribute name

kill¶

Cancel job

arcctl job kill [-h] jobid [jobid ...]

Positional Arguments¶

jobid

Job ID

killall¶

Cancel all jobs

arcctl job killall [-h]
                   [-s {ACCEPTED,PREPARING,SUBMIT,INLRMS,FINISHING,FINISHED,DELETED,CANCELING}]
                   [-o OWNER]

Named Arguments¶

-s, --state

Possible choices: ACCEPTED, PREPARING, SUBMIT, INLRMS, FINISHING, FINISHED, DELETED, CANCELING

Filter jobs by state

-o, --owner

Filter jobs by owner

clean¶

Clean job

arcctl job clean [-h] jobid [jobid ...]

Positional Arguments¶

jobid

Job ID

cleanall¶

Clean all jobs

arcctl job cleanall [-h]
                    [-s {ACCEPTED,PREPARING,SUBMIT,INLRMS,FINISHING,FINISHED,DELETED,CANCELING}]
                    [-o OWNER]

Named Arguments¶

-s, --state

Possible choices: ACCEPTED, PREPARING, SUBMIT, INLRMS, FINISHING, FINISHED, DELETED, CANCELING

Filter jobs by state

-o, --owner

Filter jobs by owner

stats¶

Show jobs statistics

arcctl job stats [-h] [-S] [-t] [-d] [-l]

Named Arguments¶

`-S, --no-states`
	Do not show per-state job stats Default: False
`-t, --total`	Show server total stats Default: False
`-d, --data-staging`
	Show server datastaging stats Default: False
`-l, --long`	Detailed output of stats Default: False