ARC Client Config Reference

Some default valued used by client tools can be refedined in the client configuration file located in ~/.arc/client.conf.

All currently supported client configuration options should be defined in the [common] block.

Warning

Other blocks (that was previously used to define target options in ARC5) are deprecated from ARC 6.5.0 release!

You can still use such blocks with legacy submission endpoint selection options for backward compatibility. But they are completely ignored with new ARC6 options set.

certificatepath

Synopsis: certificatepath = path

Description: Specify the location of client certificate file. Environmental variable X509_USER_CERT redefines this value.

Default: $HOME/.globus/usercert.pem

Example:

certificatepath=/home/user/credentials/cert.pem

keypath

Synopsis: keypath = path

Description: Specify the location of client secret key file. Environmental variable X509_USER_KEY redefines this value.

Default: $HOME/.globus/userkey.pem

Example:

keypath=/home/user/credentials/key.pem

cacertificatesdirectory

Synopsis: cacertificatesdirectory = path

Description: Specify the location of CA certificates directory Environmental variable X509_CERT_DIR redefines this value.

Default: /etc/grid-security/certificates

Example:

cacertificatesdirectory=/home/user/.globus/certificates

proxypath

Synopsis: proxypath = path

Description: Specify the location of proxy certificate (both for generation and usage) Environmental variable X509_USER_PROXY redefines this value.

Default: /tmp/x509up_u${UID}

Example:

proxypath=/home/user/credentials/proxy.pem

vomsespath

Synopsis: vomsespath = path

Description: Path to file or directory that holds client VOMS configuration to generate proxy certificates

Environmental variables X509_VOMS_FILE and X509_VOMSES redefine this value If missing arcproxy will search for vomses in the following locations:

  • ~/.arc/vomses
  • ~/.voms/vomses
  • /etc/vomses
  • /etc/grid-security/vomses

Default: undefined

Example:

vomsespath=/home/user/credentials/vomses

defaultvoms

Synopsis: defaultvoms = vo[:command]

Description: Default value for --voms (-S) arcproxy option that is used to define VO and optionaly FQANs used during proxy certificate generation

This option in multivalued.

Default: undefined

Example:

defaultvoms=atlas:/atlas/Role=pilot
defaultvoms=nordugrid.org:all
defaultvoms=ops.ndgf.org

rejectdiscovery

Synopsis: rejectdiscovery = service

Description: Specify the FQDN or URLs of the services that should be rejected during service discovery process by CLI tools (arcsub, arctest, arcresub)

This option in multivalued.

Default: undefined

Example:

rejectdiscovery=bad.service.org
rejectdiscovery=bad2.service.org

rejectmanagement

Synopsis: rejectmanagement = service

Description: Specify the FQDN or URLs of the CEs that should be skipped during the job management (e.g. arcstat, arckill)

This option in multivalued.

Default: undefined

Example:

rejectmanagement=bad3.service.org
rejectmanagement=bad4.service.org

brokername

Synopsis: brokername = broker

Description: Specify the broker used in resource discovery. The full list of installed brokers can be obtained running arcsub -P

Default: Random

Example:

brokername=FastestQueue

brokerarguments

Synopsis: brokerarguments = args

Description: Specify broker arguments (if applicable to specified broker)

Default: undefined

Example:

brokername=PythonBroker
brokerarguments=ACIXBroker.ACIXBroker:https://cacheindex.ndgf.org:6443/data/index

timeout

Synopsis: timeout = seconds

Description: Amount of time to wait for a service to respond before considering it dead.

Default: 20

Example:

timeout=60

joblist

Synopsis: joblist = path

Description: Path to the jobs database that holds all extra data about submitted jobs to be used during further job management

Default: $HOME/.arc/jobs.dat

Example:

joblist=/home/user/arcjobs.dat

joblisttype

Synopsis: joblisttype = type

Description: Type of the backend used for jobs database.

Warning

IT IS STRONGLY advised to keep default SQLITE type of backend.

Allowed values: SQLITE,, BDB,, XML

Default: SQLITE

Example:

joblisttype=XML