ARCRENEW(1)

πŸ’– arcrenew β€” ARC Proxy Renewal πŸ’–

okay bestie, welcome to the arcrenew(1) page, aka the manual for the lil command that keeps your job's proxy alive so it doesn't ghost you mid-run. grab a boba, we're doing this 🌸


✨ DESCRIPTION ✨

πŸŽ€ Usage:

arcrenew [OPTION...] [job ...]

like, that's the whole vibe. options first, then the jobs you wanna poke at 🫢

🧚 Brokering and filtering:

  • -C, --computing-element=ce β€” only pick jobs that got submitted to this computing element. very "only my faves" of you πŸ’…
  • -s, --status=statusstr β€” only pick jobs whose status is statusstr. filtering by vibe check, literally.
  • -a, --all β€” all jobs. yes, ALL of them. main character energy fr fr πŸ‘‘
  • -r, --rejectmanagement=URL β€” skip jobs that are sitting on a computing element with a given URL. not me avoiding that one cluster πŸ™ˆ

🌈 Behaviour tuning:

  • -i, --jobids-from-file=filename β€” a file containing a list of jobIDs. yes, you can just hand it a list, iconic.
  • -j, --joblist=filename β€” the file storing info about active jobs (default /builddir/.arc/jobs.dat). that's the default, no cap.
  • --no-authentication β€” do not perform any authentication for opened connections. zero auth, zero questions 😭
  • --x509-authentication β€” perform X.509 authentication for opened connections.
  • --token-authentication β€” perform token authentication for opened connections.
  • --systemca β€” force using CA certificates configuration provided by OpenSSL.
  • --gridca β€” force using CA certificates configuration for Grid services (typically IGTF).
  • --anyca β€” force using CA certificates configuration for Grid services (typically IGTF) and one provided by OpenSSL. both. both is good ✨

πŸ’… Other actions:

  • -P, --listplugins β€” list the available plugins. show me what you're working with πŸŽ€

⭐ Application Options:

  • -h, --help β€” Show help options.
  • -z, --conffile=filename β€” configuration file (default ~/.arc/client.conf).
  • -t, --timeout=seconds β€” timeout in seconds (default 20). patience is a virtue but it's finite, bestie.
  • -d, --debug=debuglevel β€” FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG. pick your yap level πŸ—£οΈ
  • -v, --version β€” print version information.

πŸ¦‹ EXTENDED DESCRIPTION πŸ¦‹

so the arcrenew command renews the delegated x509 proxy of a job submitted to an ARC CE. basically it's CPR for your proxy, and honestly? obsessed πŸ’–

you can refer to the job either by the jobid that arcsub(1) handed you back at submission time, or by its jobname β€” that's only if the job description you submitted had a jobname attribute in it. iykyk.

and you're not limited to one! more than one jobid and/or jobname can be given. if several jobs were submitted with the same jobname, the proxies of all those jobs get renewed β€” no one left behind 🫢

if you use the --joblist option, the list of jobs is read from a file with the specified filename. and by specifying the --all option, the proxies of all active jobs will be renewed. literally all of them. periodt.

the --computing-element option can be used to select or reject jobs at specific clusters. the --status option can be used to select jobs in a specific state. these options can be repeated several times β€” stack 'em like charms on a bracelet ✨ for possible state values, go see arcstat(1).


🌸 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 gets 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.

πŸ‘‘ 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 β€” they genuinely wanna hear it, fr fr πŸ’œ


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), arcresume(1), arcrm(1), arcstat(1), arcsub(1), arcsync(1), arctest(1)


and that's the whole page bestie β€” arcrenew version 7.2.0, September 2026, slay πŸ’…βœ¨ go renew those proxies, you've got this 🫢🌈

πŸ“¦ where this page comes from