guardian/cdsutils deployment

We [Jamie, Dave and Jim] recently deployed initial releases of the guardian and cdsutils software packages at LHO:

• guardian - the main guardian codebase
• cdsutils - python library and cli for CDS interaction, including ezca channelaccess library. the cdsutils python library is a depndency of

A more complete description and usage of these packages is described (or will be) on the awiki links above, but very briefly:

cdsutils is ageneral purpose tool for interacting with the CDS system that is meant to include much of the commonly needed functionality that used to be available in the old ezca/tds name space (read/write/switch/avg/etc). It is both a python library, and a CLI that wraps some of these functions for use at the command line:

controls@operator0:~ 0$ python -c "import cdsutils; print cdsutils.avg(2, 'H1:LSC-DARM_OUT')"
{'H1:LSC-DARM_OUT': 0.0}
controls@operator0:~ 0$ cdsutils avg 2 H1:LSC-DARM_OUT
H1:LSC-DARM_OUT 0.0
controls@operator0:~ 0$ 

See 'cdsutils --help' for a brief usage.

guardian is the in-development aLIGO automation system. The 'guardian' program itself serves two purposes:

• interface to execute a single state from a guardian system state machine description module.
• launch the guardian state machine engine daemon for the state machine described in a guardian system module

See also 'guardian --help' for command line usage.

installation

Both cdsutils and guardian were installed in /ligo/apps, and should be available for all users:

controls@operator0:~ 0$ which guardian
/ligo/apps/linux-x86_64/guardian/bin/guardian
controls@operator0:~ 0$ guardian --version
guardian svnr308
controls@operator0:~ 0$ which cdsutils
/ligo/apps/linux-x86_64/cdsutils/bin/cdsutils
controls@operator0:~ 0$ cdsutils --version
cdsutils svnr95
controls@operator0:~ 0$ python -c 'import ezca; print ezca.__file__'
/ligo/apps/linux-x86_64/cdsutils/lib/ezca.pyc
controls@operator0:~ 0$ python -c 'import cdsutils; print cdsutils.__file__'
/ligo/apps/linux-x86_64/cdsutils/lib/cdsutils/__init__.pyc
controls@operator0:~ 0$ 

For the moment they are installed directly from the SVN, but as they stabilize they will be installed from properly versioned releases.  The svn checkouts for both packages are in "/ligo/svncommon/CdsSVN/":

• /ligo/svncommon/CdsSVN/cdsutils -> https://redoubt.ligo-wa.caltech.edu/svn/cdsutils
• /ligo/svncommon/CdsSVN/guardian -> https://redoubt.ligo-wa.caltech.edu/svn/guardian

h1guardian0 setup

Infrastructure for management of guardian daemon processes was setup on h1guardian0.  This system manages the starting and stoping of guardian daemon processes, and logging their output.

The guardctrl tool, included with the guardian installation, is for interacting with the above described daemon supervision system.  It includes commands for creating, starting, stopping, restarting, etc. the daemons, and for accessing their logs.  It can be executed from any CDS workstation, and communicates with the setup on h1guardian0 via ssh.