.\" -*- nroff -*-
.TH ARCTEST 1 "2024-04-13" "NorduGrid ARC 6.19.0" "NorduGrid Users Manual"

.SH NAME

arctest \- ARC Test Suite

.SH DESCRIPTION

The
.B arctest
command tests basic ARC client and server setup.

.SH SYNOPSIS

.B arctest [options]

.SH OPTIONS

.IP "\fB-c\fR, \fB--cluster\fR=\fIname\fR"
select one or more computing elements: \fIname\fR can be an alias for a single CE, a group of CEs or a URL
.IP "\fB-g\fR, \fB--index\fR=\fIname\fR"
select one or more registries: \fIname\fR can be an alias for a single registry, a group of registries or a URL
.IP "\fB-R\fR, \fB--rejectdiscovery\fR=\fIURL\fR"
skip the service with the given URL during service discovery
.IP "\fB-S\fR, \fB--submissioninterface\fR=\fIInterfaceName\fR"
only use this interface for submitting (e.g. org.nordugrid.gridftpjob, org.ogf.glue.emies.activitycreation, org.ogf.bes)
.IP "\fB-I\fR, \fB--infointerface\fR=\fIInterfaceName\fR"
the computing element specified by URL at the command line should be
queried using this information interface (possible options:
org.nordugrid.ldapng, org.nordugrid.ldapglue2,
org.nordugrid.wsrfglue2, org.ogf.glue.emies.resourceinfo)
.IP "\fB-J\fR \fIjobid\fR, \fB--jobid\fR=\fIjobid\fR"
submits testjob given by the jobid.
.IP "\fB-r\fR \fItime\fR, \fB--runtime\fR=\fItime\fR"
test job runtime specified in case of the 1st test job.
.IP "\fB-j\fR, \fB--joblist\fR=\fIfilename\fR"
the file storing information about active jobs (default ~/.arc/jobs.xml)
.IP "\fB-o\fR, \fB--jobids-to-file\fR=\fIfilename\fR"
the IDs of the submitted jobs will be appended to this file
.IP "\fB-D\fR, \fB--dryrun\fR"
submit jobs as dry run (no submission to batch system)
.IP "\fB    --direct\fR"
submit directly - no resource discovery or matchmaking
.IP "\fB-x\fR, \fB--dumpdescription\fR"
do not submit - dump job description in the language accepted by the target
.IP "\fB-E\fR, \fB--certificate\fR"
prints information about installed user- and CA-certificates
.IP "\fB-P\fR, \fB--listplugins\fR"
list the available plugins
.IP "\fB-t\fR, \fB--timeout\fR=\fIseconds\fR"
timeout in seconds (default 20)
.IP "\fB-z\fR, \fB--conffile\fR=\fIfilename\fR"
configuration file (default ~/.arc/client.conf)
.IP "\fB-d\fR, \fB--debug\fR=\fIdebuglevel\fR"
FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
.IP "\fB-b\fR, \fB--broker\fR=\fIbroker\fR"
selected broker: Random (default), FastestQueue or custom
.IP "\fB-v\fR, \fB-version\fR"
print version information
.IP "\fB-h\fR, \fB-help\fR"
print usage information
.LP

.SH EXTENDED DESCRIPTION

The
.B arctest
command is used for basic testing of ARC client and server installation
through submitting various test jobs. It can also print basic information
about user's certificate. The command is complementary to
.B arcinfo
and
.B arcproxy -I

The test jobs available in this version of arctest are:

Test job 1: This test-job calculates prime-numbers for a number of minutes given by
.B -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.

Test job 2: attempts to list all environment variables at the remote site

Test job 3: copies a remote file from an HTTP server into a local file

.SH EXAMPLES

arctest -J 1 -c <clustername>

will submit test job number 1 to the specified cluster belonging to the flavor of it.

arctest --certificate

will print basic information about the user's certificate.

.SH COPYRIGHT

APACHE LICENSE Version 2.0

.SH 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

.SH SEE ALSO

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