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.
Friday, January 26. 2007
Installing PlainBlack WebGUI 6.8.8
These instructions are based upon the instructions at the Plainblack website:
For creating content, help on WebGUI content can be found at:
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.
TemplatesInternet 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