###
###  Copyright 2000-2007 University of Illinois Board of Trustees
###  All rights reserved. 
###
###  README file for psgconf
###
###  Campus Information Technologies and Educational Services
###  University of Illinois at Urbana-Champaign
###

psgconf
=======

The psgconf package is a modular system configuration framework.  It
includes a number of default modules to configure typical system
parameters, and allows administrators to add their own modules to meet
site-specific needs.


Prerequisites
-------------

You must have these modules installed in order to use psgconf:

    Config::Objective             0.9.1
    AppConfig                     1.55
    NetAddr::IP                   3.11
    Proc::ProcessTable            0.35
    Unix::Mknod                   0.02
    Text::Diff                    0.35
    version                       0.29
    Net::FTP                      1.19       # For perl < 5.8
    Storable                      2.04       # For perl < 5.8

Installation
------------

To build and install psgconf, you should be able to simply run these
commands:

   perl Makefile.PL [options]
   make
   make test
   make install

The following options are available as arguments to Makefile.PL:

   --etcdir=DIR		Install default config files in DIR
			[default: $(DESTDIR)/etc]
   --sharedir=DIR	Install library files in DIR
			[default: $(DESTDIR)/usr/local/share/psgconf]

To create a temporary directory to bundle up psgconf for a package
manager, set the DESTDIR directive in the install:

    make DESTDIR=/scratch install

For SVR4 packages, there is a svr4pkg make target that will copy
over the depend, pkginfo and create the prototype files in $(DESTDIR).

    make DESTDIR=/scratch svr4pkg


More Information
----------------

For reference-mode information, see the POD documentation for each module.
New users should start by reading the psgconf-intro.pod file.

For more information on the psgconf package, see:

   http://www-dev.cites.uiuc.edu/psgconf/

The lastest source code is available at:

   ftp://ftp-dev.cites.uiuc.edu/pub/psgconf/


License
-------

psgconf is distributed under a BSD-style license.  See the COPYRIGHT
file for the full text of the license.