75 lines
2.2 KiB
Text
75 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://www.plainblack.com/installing_webgui
|
|
|
|
QnD INSTALL INSTRUCTIONS:
|
|
|
|
1. Install Perl 5.6.x or greater. (5.8.x recommended)
|
|
|
|
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
|
|
XML::Simple
|
|
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";
|