webgui/docs/install.txt
2004-08-30 23:05:03 +00:00

74 lines
2.2 KiB
Text

##################################################################
# 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
HTML::Parser
Archive::Tar
Compress::Zlib
IO::Zlib
SOAP::Lite
Cache::Cache
Time::HiRes
Image::Magick (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";