VacProject       Vac       Vac-in-a-Box       Vcycle       VacMon       GridPP      

VAC

NAME
SYNOPSIS
DESCRIPTION
GENERAL OPTIONS
COMMANDS
CONFIGURATION FILES
AUTHOR
SEE ALSO

NAME

vac − Vac utility command

SYNOPSIS

vac [options] command

DESCRIPTION

vac is a command-line utility for querying the status of vacd(8) factory machines.

The format of the results of this command may change without notice, and should not be relied on by other scripts etc.

GENERAL OPTIONS

-h, --help

Show help message and exit

-s SPACENAME, --space=SPACENAME

Override Vac space given in the configuration file

-t UDPTIMEOUTSECONDS, --timeout=UDPTIMEOUTSECONDS

Set timeout in seconds for UDP queries

-J, --json

Return output as a JSON document rather than as a list

COMMANDS

machines [factory1] [factory2] [...]

This command uses the VacQuery UDP Protocol to contact the factory machines in this Vac space and outputs a summary of their responses. Each line in the output corresponds to the reported status of one virtual machine slot. This command can be used to get a quick overview of the status of a Vac space, including which machinetypes are running and where, and the outcomes of virtual machines that are currently shut down. By default all factories in the current space are contacted, but this can be limited to one or more by giving the hostnames of factory machines on the command line. Hostnames will be canonicalised if the FQDN isn’t given.

For running machines, the time running, the lifetime CPU efficiency, and the recent CPU efficiency are shown. The CPU efficiency is CPU time used divided by elapsed seconds, and may be more than 100% for virtual machines with more than one CPU.

machinetype MACHINETYPE

Shows the most recent status of the given machinetype on the virtual machine slots of all factories that respond. This includes virtual machines which ran for this machinetype but have shut down, and will display their shutdown times and messages if available. Also displayed are the number and total HS06 of running VMs.

factories factory1 [factory2] [...]

Outputs the responses from one or more factory machines, running/total CPUs, running/total VM slots, 15 minute CPU load average, free space on the disk(s) containing / and /var/lib/vac, the used/total memory, and the Vac version of the factory.

proxy-init

Requires the --cert and --key options and may take the --legacy-proxy option. Creates a legacy Globus proxy or RFC proxy (the default.)

cernvm-signature image

Outputs the CernVM metadata and signature information from an image, indicating if the signature verification succeeded and the associated signing X.509 DN.

apel-sync [YYYYMM [YYYYMM [YYYYMM ... ]]]

Takes zero or more six digit year-month strings and writes APEL Sync message record file(s) to today’s subdirectory of /var/lib/vac/apel-outgoing based on the corresponding months’ records in daily subdirectories of /var/lib/vac/apel-archive . If no year-month string is given on the command line, then the year-month containing the time 24 hours before now is used. This means that vac apel-sync can be run every day from cron to publish sync summaries of the current month’s progress, with a final whole-month summary being published during the first day of the next month.

squid-conf inputfile outputfile

Creates a configuration file for a per-factory Squid cache using inputfile as a template, appending acl and cache_peer lines for the factory FQDNs listed in the Vac configuration. The result is only written to outputfile if the contents differ from the current outputfile, which means the timestamp of outputfile can be checked to see whether Squid needs to reload its configuration.

CONFIGURATION FILES

The vac command uses the settings of the vac.conf(5) configuration by default, unless overriden by the command line options described above.

AUTHOR

Andrew McNab <Andrew.McNab@cern.ch>

The vac command is part of Vac: http://www.gridpp.ac.uk/vac/

SEE ALSO

vacd(8), vac.conf(5)