2007 Jan 25 - Thu

Installing PlainBlack WebGUI 6.8.8

The PlainBlack WebGUI documentation server install requires the use of the Fedora Core 4 base build. If you are using VMWare, be sure to Snap Shot the base build so you can roll back the installation should the need arise.

These instructions are based upon the instructions at the Plainblack website:

http://www.plainblack.com/installing_webgui

For creating content, help on WebGUI content can be found at:

http://www.plainblack.com/?op=viewHelpIndex

http://www.plainblack.com/?op=viewHelpTOC

Install various packages required by WebGUI:

yum install perl-XML-Simple
yum install ghostscript-fonts
yum install ImageMagick ImageMagick-devel ImageMagick-perl
yum install libapreq2 libapreq2-devel
yum install perl-libapreq2

There are some additional perl modules to be installed:

perl -MCPAN -eshell
install Cache::Cache
install Devel::Symdump
install Pod::Coverage
install HTML::Parser
install Archive::Zip
install Tie::IxHash
install Tie::CPHash
install Class::Singleton
install Module::Build
install Params::Validate
install DateTime::TimeZone
install DateTime::Locale
install DateTime::Format::Strptime
install DateTime::Cron::Simple
install DateTime
install Time::HiRes
install IO::Stringy
install Mail::Field
install Mail::Header
install Mail::Internet
install MIME::Parser
install SOAP::Lite
install Log::Log4perl
install Net::LDAP
install HTML::Highlight
install HTML::TagFilter
install HTML::Template
install Parse::RecDescent
install HTML::Template::Expr (optional)
#install Template (optional)no
install Parse::PlainConfig
install XML::RSSLite
install JSON
install HTML::TableExtract
install Finance::Quote
install Pod::Escapes
install Pod::Simple
install Clone
install Test::Pod
install Data::Structure::Util

Obtain the latest WebGUI installation:

cd /usr/src
wget http://www.plainblack.com/downloads/6.x.x/webgui-6.8.8-gamma.tar.gz

WebGUI Installation:

tar -zxvf webgui-6.8.8-gamma.tar.gz
mkdir /data
mv WebGUI /data/
touch /data/webgui.log

chown apache /data/webgui.log
crontab -e
   0 * * * * cd /data/WebGUI/sbin/; perl runHourly.pl >/dev/null 2>/dev/null
mkdir  -p /data/domains/oneunified.net/docs/public
cd /data/domains/oneunified.net/docs
mkdir logs
cp /data/WebGUI/etc/WebGUI.conf.original /data/WebGUI/etc/docs.oneunified.net.conf
cp /data/WebGUI/etc/log.conf.original /data/WebGUI/etc/log.conf
cd public
cp -R /data/WebGUI/www/uploads ./
chown apache uploads
cd /data/WebGUI/etc
service mysqld start
mysql -e "create database docs_oneunified_net"

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

Edit the file /data/WebGUI/etc/docs.oneunified.net.conf:

sitename = docs.oneunified.net, oneunified.net
uploadsPath = /data/domains/oneunified.net/docs/public/uploads
passthruUrls => /icons
dsn = DBI:mysql:docs_oneunified_net
dbuser = webgui
dbpass = webgui
authMethods = WebGUI
logfile = /data/webgui.log

Edit the file /data/WebGUI/etc/log.conf:

log4perl.appender.mainlog.filename = /data/webgui.log

Changes need to be made to the /etc/httpd/conf/httpd.conf file. Just prior to <Directory "/var/www/html">, insert the following block of code:

#LoadModule apreq_module modules/mod_apreq2.so
#LoadModule perl_module modules/mod_perl.so
PerlSetVar WebguiRoot /data/WebGUI
PerlCleanupHandler Apache2::SizeLimit
PerlRequire /data/WebGUI/sbin/preload.perl
Alias /extras /data/WebGUI/www/extras
Alias /uploads /data/domains/oneunified.net/docs/public/uploads

Append to the end of the file the following lines:

<VirtualHost *:80>
        ServerName docs.oneunified.net
        ServerAlias oneunified.net
        DocumentRoot /data/domains/oneunified.net/docs/public
        SetHandler perl-script
        PerlInitHandler WebGUI
        PerlSetVar WebguiConfig docs.oneunified.net.conf
</VirtualHost>

Elsewhere in the file, update the line:

ServerName docs.oneunified.net:80

To finish up, check that all libraries have been installed:

cd /data/WebGUI/sbin/
perl testEnvironment.pl

You should get a final OK for everything.

Start the Web server:

service httpd start

You should get an appropriate OK result. If not, check the /var/log/httpd/error_log file to see what errors have occurred.

Set the services for auto-start:

chkconfig --level 345 httpd on
chkconfig --level 345 mysqld on

Once the web service is running, run 'ifconfig' to obtain the machines address. Bring up a web browser and go to that address. You should be able to log in. After logging in, put in the company name, url, and email address.

Internet Explorer insists on rendering .txt documents when it sees stuff in it that it thinks can be rendered. Hence, when clicking on the template in IE, you'll see junk. Right click on the resulting document and look at the source. That is the original source. Firefox resolves the file just fine--as in it doesn't do any rendering.

plainblack.template.txt