SourceFiles.org - Use the Source, Luke

Welcome to AGDA (Andataco Gigastor Device Adminstrator)

http://www.lysator.liu.se/~pen/agda

INTRODUCTION

This is a tool (Agda) and a daemon (Bagdad) that controls and monitors Andataco/nStor GigaSTOR (GigaRAID) 8000 SCSI disk monitored storage units.

LICENSE

Agda is freely available and may be used by anyone without any restrictions except that you may not pretend that you wrote this...

If you find this to be a valuable tool then I'd gladly accept a nice bottle of whisky (or suitable alternative - a postcard would be fine also. Or a simple email :-).

INSTALLATION

Build Agda with "make" after you've modified the Makefile for your system.

Two binaries will be built:

agda

This is a command line tool that can be used to query one or multiple GigaStor units, and/or be used as a NetSaint plugin (with the "-N" command line option). For a complete list of options run it with the "-h" (help) option.

The device can be specified either as a device name (/dev/cua/b) or a logical name specified in the /etc/remote file.

It also has an interactive command line interface mode which it'll enter by default if you don't specify the "-N" option. From this CLI you can query the GigaStor:s for various information and even change things - like spin up/down disks, alter the state of various LEDs, turn on/off the alarm and more. For a complete list of commands enter "help" in the CLI.

By default it'll start up with no chassis and drives selected. You can either select via an command line option (-C and -D) or inside from the CLI ("chassis" and "drives"). Valid arguments are "none", "all", or a chassis number or a chassis range.

Using "all" agda will ignore any chassis not installed - but if you really want for force a check (and generate an error message) then you should specify the used chassis as a range). Ie, you check chassis 0 to 5 from Netsaint, call it like this:

agda -C0-5 -N /dev/cua/0

To get a dump of all installed chassis call it like this:

agda -Call /dev/cua/0 "show firmware"

This binary supports (and probably should be) being installed as setuid root (in order to be able to create lock files for the TTY). It'll automatically drop the root privileges after startup and it will be default not allow any dangerous commands to be issued from non-root users (the "enable" command must be executed, and it'll prompt for a root password for non-root users).

From the interactive command line you can give pseudo-IOS-like commands. "?" can be used to get interactive help on available commands and options. For example:

?
show ?
show chassis ?
set drive ?

bagdad

This is a daemon that can be started in the background that will forward all events received from Gigastor units to the Unix syslog system.

It will also allocate a UNIX domain socket that will forward all data to/from the real serial port - this is so that the Agda program be used concurrently with Bagdad.

Start it with the serial port of the GigaStor chain as an argument:

        ./bagdad /dev/cua/0
        ./bagdad bigserver

It'll fork and put itself into the background.

Now you can run multiple Agda clients at the same time, via the UNIX domain sockets created in /dev/agda/. For example:

        ./agda /dev/agda/0
        ./agda /dev/agda/bigserver

---
2002-01-20 - Peter Eriksson <pen@lysator.liu.se>