plainblack.com
Username Password
search
Bookmark and Share
Subscribe

Gentoo Linux

While all flavors of Linux are supported for WebGUI, these instructions for Gentoo Linux were contributed and are not officially supported.
##################################################################
# 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:

There are 2 methods:
1) CPAN shell installation
perl -MCPAN -e shell
cpan> install LWP
cpan> install DBI
cpan> install DBD::mysql
cpan> install Digest::MD5
cpan> install Date::Calc
cpan> install Image::Magick

2) use gentoo emerge system
LWP; aka. libwww-perl
DBI
DBD::mysql
Digest::MD5
Date::Calc
ExtUtils-MakeMaker
Image::Magick; aka. PerlMagic; requires "ExtUtils-MakeMaker"

steps:
1. emerge libwww-perl DBI DBD-mysql Digest-MD5 Date-Calc \
ExtUtils-MakeMaker imagemagick

2. get PerlMagick from CPAN; install it
Notice: PerlMagick version has to be related to imagemagick,
ex: imagemagick is 5.5.3.2; then, PerlMagick has to be 5.53

3. Install Apache (with or without mod_perl) and set up your config.
a. emerge apache mod_ssl mod_perl

b. edit /etc/conf.d/apache
add "-D SSL -D PERL" to $APACHE_OPTS

c. add the following to /etc/apache/conf/apache.conf:

LoadModule perl_module extramodules/libperl.so


LoadModule ssl_module extramodules/libssl.so


# I can not make WebGUI to work with apache2
# Basically that is because my CGI.pm can not work with mod_perl 1.99.xx
# well.
# refer to:
# /usr/share/doc/apache-1.3.27-r3/manual/vhosts/name-based.html
d. edit "/etc/apache/conf/Vhosts.conf"
you may choose either IP or DNS based Vhost mapping:

# IP Based Vhost.conf
### Vhosts.conf begin
#configuration copied from WebGUI
# give an IP for your VirtualHost
#User apache
#Group apache

SetHandler perl-script
# for apache 1.3.xx, Apache::Registry
# for apache 2.xx, ModPerl::Registry or ModPerl::PerlRun
PerlHandler Apache::Registry
Options +ExecCGI

DocumentRoot /opt/apache/WebGUI/www
ServerName sis3155.sis.com
Setenv VLOG /opt/apache/WebGUI/log
#ServerAlias test_yslee.com
ErrorLog /opt/apache/WebGUI/log/error-log
#CustomLog /opt/apache/logs/access-log env=!VLOG
RewriteEngine On
RewriteOptions inherit



AllowOverride All
Order allow,deny
Allow from all

# end of vhosts.conf

# DNS Based Vhost.conf
# configuration copied from WebGUI at joulee.dyndns.org
# Vhosts.conf begin
NameVirtualHost *
# give wildcard here; assign ServerName later

#User apache
#Group apache

SetHandler perl-script
# for apache 1.3.xx, Apache::Registry
# for apache 2.xx, ModPerl::Registry or ModPerl::PerlRun
PerlHandler Apache::Registry
Options +ExecCGI

DocumentRoot /opt/apache/joulee/www
# give the ServerName for VirtualHost
ServerName joulee.dyndns.org
Setenv VLOG /opt/apache/joulee/log
#ServerAlias test_yslee.com
ErrorLog /opt/apache/joulee/log/error-log
#CustomLog /opt/apache/logs/access-log env=!VLOG
RewriteEngine On
RewriteOptions inherit



AllowOverride All
Order allow,deny
Allow from all

# end of joulee.dyndns.org
# Vhosts.conf end

e. add/uncomment the following line in "/etc/apache/conf/apache.conf"
CustomLog "|/usr/sbin/apachesplitlogfile" vhost env=VLOG

f. In "commonapache.conf", turn "UseCanonicalName off" if you do not
have a domain-name. In this case, you have to use IP-Based
VirtualHost settings.

4. Install MySQL.
emerge mysql
ebuild /var/db/pkg/dev-db/mysql-3.23.55/mysql-3.23.55.ebuild config

PLEASE REMEMBER TO SET A PASSWORD FOR THE MySQL root USER !
This is done with:
/etc/init.d/mysql start (you have to start the server first!)
/usr/bin/mysqladmin -u root password 'new-password'
# the following step seems not working
/usr/bin/mysqladmin -u root -h pdp8 password 'new-password'
See the manual for more instructions.

su - mysql
mysql -u root -p
> status


5. Extract WebGUI into your webroot.
cd /opt
sudo mkdir apache
cd apache
gzip -cd ~/src/webgui/webgui-5.0.3.tar.gz | sudo tar xvf -
cd WebGUI #IP based Vhosts.conf
# create the log directory for the vhost, WebGUI.
sudo mkdir log


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

su - mysql
mysql -u root -p

mysql -e "create database WebGUI"
# setup user/password for database "WebGUI" where 'password' == '456456'
mysql -e "grant all privileges on WebGUI.* to webgui@localhost identified by 'password'"
mysql -e "flush privileges"

# Or you may do above commands under mysql prompt:
create database WebGUI;
grant all privileges on WebGUI.* to webgui@localhost identified by '456456';
flush privileges;
# exit mysql prompt

# for IP based vhosts:
cd /opt/apache/WebGUI
# for DNS based vhosts:
cd /opt/apache/joulee

#mysql -uwebgui -ppassword WebGUI < docs/create.sql
mysql -uwebgui -p456456 WebGUI < docs/create.sql

7. Edit "etc/WebGUI.conf" to patch your DB settings and log directory.
# WebGUI.conf
dsn = DBI:mysql:WebGUI
dbuser = webgui
dbpass = 456456
logfile = /opt/apache/WebGUI/log/webgui.log
extrasURL = /extras
extrasPath = /opt/apache/WebGUI/www/extras
uploadsURL = /uploads
uploadsPath = /opt/apache/WebGUI/www/uploads
# end of WebGUI.conf


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".

9. make sure you do not have proxy setting problem.

10. create webgui.log and chown to "apache:apache"
cd /opt/apache/WebGUI/log
touch webgui.log
chown apache:apache webgui.log

11. chown the "uploads" dir to "apache:apache" to enable file uploads
cd /opt/apache/WebGUI/www
chown -R apache:apache uploads
Mac OSX Fink 

Keywords:

Search | Most Popular | Recent Changes | Wiki Home
© 2018 Plain Black Corporation | All Rights Reserved