Flux»Projects


RackMonkey 1.2.4 Admin Guide

RackMonkey 1.2.4 Documentation Index

RackMonkey Version 1.2.4
©2004-2008 Will Green (wgreen at users.sourceforge.net)
Licensed under the GNU Public Licence v2.

Overview

For basic installation and configuration information see the install guide. This document will be expanded in future releases. NB. This document is available from within RackMonkey by clicking on the 'Help' tab at the top of the screen.

Restricting Access and Recording Who Made Changes

Password Protecting RackMonkey

You can control access to RackMonkey using standard Apache auth (often configured in an .htaccess file). If you set up accounts this way RackMonkey will use the username in the change log so you can see who changed what and when (if you don't use accounts the IP is recorded instead). I recommend you create a separate account for each RackMonkey user, that way you'll know who updated what and when. For information on setting up authentication using Apache see: Apache Docs (online).

Read Only Access

To allow a user read only access to RackMonkey create an account called 'guest' (with any password you choose). A guest account has full read access but cannot edit anything.

Change Log

Every time a record is edited in RackMonkey the details of the change are recorded. The time and user of the last change is visible at the bottom of an entry, something like 'Entry last updated by bob at 2007-02-15 13:22:56 GMT'. If you haven't set up accounts (see above), then the IP address of the user is shown instead.

To see the full change log for RackMonkey you need to use the logdump command line tool. Locate the perl directory from your RackMonkey install (contains the rackmonkey.pl script) and cd into it (the logdump script needs to be run from the perl directory), you can then run the logdump command to see all the changes. For example:

$ cd /home/rackmonkey/perl
$ bin/logdump
Table Action                Name     ID    Changed (GMT)     Changed By
===============================================================================
app insert                    Foo      1 2008-07-02 20:07             ::1
device update                 mon      5 2008-07-07 11:10             ::1
device update                 db2      4 2008-07-07 11:10             ::1
device insert                 foo     10 2008-07-07 11:11             ::1
device delete                   -     10 2008-07-07 11:11             ::1
===============================================================================

You can see more options by running logdump -h. In a later release this information will be available via the web interface.

RackMonkey 1.2.4 Documentation Index