##############################################################################
# RackMonkey - Know Your Racks - http://www.rackmonkey.org                   #
# Version 1.3.%BUILD%                                                        #
# (C)2004-2010 Will Green (wgreen at users.sourceforge.net)                  #
# README for RackMonkey 1.3.0 alpha 1                                        #
##############################################################################

You can read the latest version of this document in HTML format at:
http://www.rackmonkey.org/doc/1.3

WARNING: This is an alpha release that has undergone limited testing. The
author does not recommend using this release for production usage.
The RackMonkey 1.3 documentation is still being updated and you should expect
to find omissions and inaccuracies in it. For the latest production version,
please visit http://www.rackmonkey.org.


Contents
========
1. Introduction
2. New in this Release
3. Obtaining RackMonkey
4. Installation
5. Documentation
6. Support
7. Acknowledgements
8. Legal Notices
9. RackMonkey Licence


1. Introduction
===============
RackMonkey is a web-based tool for managing racks of equipment such as web
servers, video encoders, routers and storage devices. Using a simple interface 
you can keep track of what's where, which OS it runs, when it was purchased, 
who it belongs and what it's used for. No more searching for spreadsheets or 
scribbled notes when you need to find a server: RackMonkey can quickly find 
any device and draw a rack diagram of its location. RackMonkey is free and 
open source (licensed under GPL).

This is an alpha release of 1.3. For production usage you should use the
latest stable release from: http://www.rackmonkey.org


2. New in this Release
======================
1.3.0 has a number of improvements over 1.2.5. These include:


For a more detailed list of changes in this and prior releases
see doc/changes.txt.

Final 1.3 features are subject to change.


3. Obtaining RackMonkey
=======================
The easiest way to obtain a copy of RackMonkey is to download a tarball of the
current release from http://www.rackmonkey.org.


4. Installation
===============
For new installation refer to: doc/install.txt.
For upgrades from prior releases refer to: doc/upgrade.txt


5. Documentation
================
You can find RackMonkey documentation:

* In the doc directory included in the RackMonkey distribution
* Within the application itself by selecting the help tab
* Online at http://www.rackmonkey.org/doc
* Perl pod is included in the perl modules. This can be viewed with perldoc.


6. Support
==========
If you have and questions or issues with RackMonkey please check the following
resources:

* RackMonkey documentation (see above)
* Troubleshooting document: doc/troubleshooting.txt
* FAQ: http://www.rackmonkey.org/faq

If you're still stuck, please log a support request at:

    http://www.rackmonkey.org/support

When logging a support request please include as much detail as possible:
operating system, database software and revision, and any error messages.

You should also join the announce list to hear about issues and new releases:

    http://lists.sourceforge.net/lists/listinfo/rackmonkey-announce


7. Acknowledgements
===================
I would like to thank the following for their contribution of code to the
RackMonkey project:

	* Eric F Crist - FreeBSD port
    * Pierre Larsson - Excel spreadsheet export functionality
    

Many people have helped me with the development of RackMonkey, but I would
especially like to thank the following:

    * Ben Argyle
    * Piers Kent
    * Tim Sweetman
    * Nicola Worthington
    

Apps, code or ideas from the following projects helped or inspired RackMonkey
development:

    * FamFamFam (Mark James): http://www.famfamfam.com
        Icons used in RackMonkey interface.
    * Homo Habilis Associates: http://habilis.net/validator-sac
        Standalone W3C validator used to check RackMonkey templates.
    * silverorange: http://labs.silverorange.com
        Inspiration for tabbed CSS design.
    * SQLite project: http://www.sqlite.org
        Original RackMonkey database engine.

    
8. Legal Notices
================
RackMonkey (C)2004-2010 Will Green. 
RackMonkey and "Know Your Racks" are trademarks of Will Green.

The inclusion of a particular company or product in RackMonkey data does
not imply an endorsement by the author.

RackMonkey includes icons licensed from Mark James under the Creative Commons
Attribution 2.5 License. See http://www.famfamfam.com/lab/icons/silk/.


9. RackMonkey Licence
=====================
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.