pippy (Pacman Information Provider in PYthon)
version 0.3

This is the readme file for pippy, an MDS information provider for pacman.
More information is available at http://www-hep.uta.edu/~mcguigan/pippy


The released file consists of:
README       This file
pip.py       The information provider
pip.schema   LDAP schema elements that the information provider uses
install.py   An installer program (normally ran from within pacman)
remove.py    A de-installer program (normally ran from within pacman)
girl.conf    A grid-info-resource-ldif.conf entry for the information provider


At this time, the information provider and schema should be considered beta
code.  It is likely that both the schema and the information provider 
will evolve over time.

The information provider can read a pacman database and create LDAP entries
for each installed package.  The package entries will share a common parent
entry in the LDAP Directory Information Tree (DIT).  In pippy's case the 
parent will be:

dn: UTA-SW-Collection-Name= <pacman>, Mds-Host-hn = <fqdn>, Mds-Vo-name = local, O = grid
where <pacman> is a configurable collection name and <fqdn> is the full
host name of the machine.

Installation:
-------------

The package is released as a tar file and is expected to be installed through
pacman.  The person installing the program should have write access to 
the $GLOBUS_LOCATION/etc directory (which most likely is root). During
installation, the install.py script will be called and will automatically
configure pippy for use.  The install program makes a few assumptions:

    1) $GLOBUS_LOCATION is defined
    2) The parent directory of the directory that contains the installer
       contains a pacman database.

The results of the installation are:
    1) $GLOBUS_LOCATION/etc/grid-info-slapd.conf and
       $GLOBUS_LOCATION/etc/grid-info-resource-ldif.conf are
       backed up with ".pippy" extensions

    2) $GLOBUS_LOCATION/etc/grid-info-slapd.conf is modified
       to include the pip.schema file

    3) $GLOBUS_LOCATION/etc/grid-info-resource-ldif.conf is modified
       so that entry exists to run the information provider.


Removal:
--------

In the case that you wish to remove the information provider there are two 
steps:

    1) Use pacman to remove the package with 
         $ pacman -remove pippy

       A removal program is executed that deletes pippy related entries in 
       $GLOBUS_LOCATION/etc/grid-info-slapd.conf and 
       $GLOBUS_LOCATION/etc/grid-info-resource-ldif.conf
       after making backups with a .pippy_rm extension.