ARCTEST(1)

📦
version 7.2.0 · 14 versions
, in fedora 43, fedora 44

💖 ARCTEST(1) — the arctest manual, bestie edition 💖

okay so welcome to arctest, aka the ARC Test Suite — it's a User Command, and it's giving "let me poke your cluster and see if it's actually alive" ✨

🌸 NAME 🌸

arctest — the ARC Test Suite. that's it, that's the name, she's simple and she's iconic 💅

✨ DESCRIPTION ✨

🫶 Usage:

arctest [OPTION...]

so basically? the arctest command is what you use for testing clusters as resources. like, vibe-checking a whole grid cluster. no cap 🦋

🎯 Target endpoint selection

this is where you tell her where to go 👑

  • -C, --computing-element=ce — the computing element hostname, OR a full complete endpoint URL if you're feeling fancy 💖
  • -Y, --registry=registry — registry service URL, and you can optionally specify the protocol too ✨
  • -T, --submission-endpoint-type=type — demands a specific endpoint type for job submission, like she's picky (she is, and she's allowed to be). Allowed values are: arcrest and internal.
  • -Q, --info-endpoint-type=type — requires the information query to use the specified information endpoint type. Special value 'NONE' will disable all resource information queries AND the following brokering — so like, no info, no brokering, nothing, ghost mode 💀 Allowed values are: ldap.nordugrid, ldap.glue2, arcrest and internal.

🔍 Brokering and filtering

  • -R, --rejectdiscovery=URL — skips the service with that given URL during service discovery. not on my watch, bestie 🙈
  • -b, --broker=broker — picks the broker method. you can list all the available brokers with the --listplugins flag, iykyk 🎀

🎛️ Behaviour tuning

the knobs and dials section, obsessed 😭

  • -o, --jobids-to-file=filename — the IDs of the submitted jobs get appended to this file 📝
  • -n, --no-delegation — do NOT perform any delegation for submitted jobs. none. zero. nope ✋
  • -X, --x509-delegation — performs X.509 delegation for submitted jobs 🔐
  • -K, --token-delegation — performs token delegation for submitted jobs 🎟️
  • --instances-max — request at most this number of job instances submitted in a single submit request
  • --instances-min — request at least this number of job instances submitted in a single submit request
  • --allowinsecureconnection — allows a TLS connection which failed verification. bestie. be careful. that's the whole point of verification 😭
  • -j, --joblist=filename — the file storing info about active jobs (default /builddir/.arc/jobs.dat)
  • --no-authentication — do not perform any authentication for opened connections 🙈
  • --x509-authentication — performs X.509 authentication for opened connections
  • --token-authentication — performs token authentication for opened connections
  • --systemca — forces using the CA certificates configuration provided by OpenSSL
  • --gridca — forces using CA certificates configuration for Grid services (typically IGTF) 🌐
  • --anyca — forces using CA certificates configuration for Grid services (typically IGTF) and one provided by OpenSSL. both. she said both 💅

🚀 Other actions

  • -J, --job=int — submits the test job given by that number 🔢
  • -r, --runtime=int — test job runtime, specified by the number ⏱️
  • -D, --dryrun — submits jobs as a dry run, meaning no submission to the batch system 🏃♀️
  • -x, --dumpdescription — does NOT submit — instead dumps the job description in the language accepted by the target 📄
  • -E, --certificate — prints info about installed user- and CA-certificates 🪪
  • -P, --listplugins — lists all the available plugins 🧩

⚙️ Application Options

  • -h, --help — shows help options 🆘
  • -z, --conffile=filename — configuration file (default ~/.arc/client.conf)
  • -t, --timeout=seconds — timeout in seconds (default 20) ⏳
  • -d, --debug=debuglevel — one of: FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG 🐛
  • -v, --version — prints version information 📌

🌈 EXTENDED DESCRIPTION 🌈

so the arctest command is mainly used for basic testing of job submission to ARC CE using various pre-defined test jobs. she supports all the target selection options available for arcsub and she uses the same brokering logic. twin behavior, fr fr 👯

she can also print basic info about the user's certificate 🪪✨ The command is complementary to arcinfo and arcproxy -I.

the test jobs available in this version of arctest are:

  1. Test job 1: This test-job calculates prime-numbers for a number of minutes given by -r (default 5) and outputs the list to stderr. The source-code for the prime-number program, the Makefile and the executable are downloaded to the cluster from HTTP and FTP servers, and the program is compiled before running. In this way, the test job constitutes a fairly comprehensive test of the basic setup of a grid cluster. like she's doing a full-body checkup on your cluster 💖
  2. Test job 2: attempts to list all environment variables at the remote site 🌍
  3. Test job 3: copies a remote file from an HTTP server into a local file 📁

📂 FILES 📂

  • ~/.arc/client.conf — some options can be given default values by specifying them in the ARC client configuration file. By using the --conffile option, a different configuration file can be used than the default.
  • ~/.arc/jobs.dat — this is a local database of the user's active jobs. When a job is successfully submitted, it's added to the database, and when it's removed from the remote CE, it's removed from this list. This database is used as the list of all active jobs when the user specifies the --all option to the various NorduGrid ARC user interface commands. By using the --joblist option, a different file can be used than the default.

🍓 EXAMPLES 🍓

arctest -J 1 -C <computing element>

will submit test job number 1 to the specified CE. slay, go off 👑

👑 AUTHOR 👑

ARC software is developed by the NorduGrid Collaboration (http://www.nordugrid.org) — please consult the AUTHORS file distributed with ARC. Please report bugs and feature requests to http://bugzilla.nordugrid.org 🐛💌

APACHE LICENSE Version 2.0

🦋 SEE ALSO 🦋

arccat(1), arcclean(1), arccp(1), arcget(1), arcinfo(1), arckill(1), arcls(1), arcmkdir(1), arcproxy(1), arcrenew(1), arcresume(1), arcrm(1), arcstat(1), arcsub(1), arcsync(1)

and that's the whole page, bestie!! 💖✨🎀🦋🌸

this was arctest version 7.2.0, dated September 2026 — mwah, go test some clusters, you absolute icon 💅👑

📦 where this page comes from