##################################################################
#              Quick And Dirty Install Instructions              #
##################################################################

The following is a rough overview of how to install WebGUI. For
more detailed instructions read the WebGUI installation 
documentation.
   
   http://plainblack.com/installation

QnD INSTALL INSTRUCTIONS:

1. Install Perl 5.6.x or greater.

2. Install the following Perl modules:

   LWP
   DBI
   DBD::mysql
   Digest::MD5
   Date::Calc
   HTML::Parser 
   Archive::Tar
   Compress::Zlib
   Image::Magick (optional)
   Cache::FileCache (optional)

3. Install Apache (preferably with mod_perl) and set up your config.
   If you are using Apache 2, see the additional instructions below.

4. Install MySQL.

5. Extract WebGUI into your webroot.

6. Run the following Database commands. (You should modify the
   commands to match your database, username, and password.)

   mysql -e "create database WebGUI"
   mysql -e "grant all privileges on WebGUI.* to webgui@localhost identified by 'password'"
   mysql -e "flush privileges"
   mysql -uwebgui -ppassword WebGUI < docs/create.sql

7. Edit "etc/WebGUI.conf" to match your DB settings and log directory.

8. Run the following command from your WebGUI/sbin directory to determine
   whether you've configured your system correctly.

   perl testEnvironment.pl

   If it returns all "OK" then you're done. The default admin account 
   info is "Admin" and "123qwe".

##################################################################
#          Apache 2/mod_perl 1.99+ Additional Instructions       #
##################################################################

In order to get WebGUI to run under Apache 2, several files need to 
be modified after you have completed all of the steps above.

1. In "sbin/preload.perl", comment out the following mod_perl 1 line:
   # use Apache::Registry (); 

2. Uncomment the next line:
   use ModPerl::Registry (); 

3. In "www/index.pl", comment out the following line:
   # $webguiRoot = "..";

4. Uncomment the next line, making sure to change this to your own
   full path to WebGUI:
   $webguiRoot = "/data/WebGUI"; 
