104 lines
3.1 KiB
Text
104 lines
3.1 KiB
Text
##################################################################
|
|
# Quick And Dirty Install Instructions #
|
|
##################################################################
|
|
|
|
The following is a rough overview of how to install WebGUI *8*.
|
|
|
|
http://wiki.webgui.org/installation-options has instructions for
|
|
WebGUI 7.
|
|
|
|
== INSTALL ==
|
|
|
|
* Install a recent Perl (5.12.1 or better) if you don't have one already
|
|
|
|
* Install a recent MySQL and set up a user account
|
|
|
|
* Install ImageMagick (http://www.imagemagick.org/, compile and install the
|
|
source or binary package)
|
|
|
|
* Get WebGUI from GitHub and check out the WebGUI8 branch:
|
|
|
|
$ git clone https://github.com/plainblack/webgui.git
|
|
$ git checkout WebGUI8 --track
|
|
|
|
* Setup your configuration files
|
|
|
|
Copy WebGUI.conf.original to something named after the site's URL and
|
|
ending in .conf, such as www.example.com.conf, and edit it, making sure
|
|
to insert your site's URL and the database connection information
|
|
(dbuser, dbpass, dsn).
|
|
|
|
Set uploadsPath in the .conf file to eg
|
|
/data/domains/www.example.com/public/uploads/.
|
|
|
|
Edit "etc/spectre.conf" to define port and worker settings for spectre.
|
|
|
|
Set WEBGUI_CONFIG to point at your new configuration file:
|
|
|
|
$ export WEBGUI_CONFIG='/data/WebGUI/etc/www.example.com.conf'
|
|
|
|
* Automatically install new Perl module dependencies:
|
|
|
|
$ sbin/testEnvironment.pl as root to install Perl modules
|
|
|
|
* Create a MySQL user account for the domain WebGUI is to host
|
|
and share/create.sql into that database
|
|
|
|
$ mysql --password --user=root -e "create database www_example_com"
|
|
$ mysql --password --user=root -e "grant all privileges on www_example_com.*
|
|
to webgui@localhost identified by 'XXXXpasswordhereXXXX'"
|
|
$ mysql --password --user=webgui < share/create.sql
|
|
|
|
* wgd reset --uploads
|
|
|
|
* Continue with the UPGRADE instructions below
|
|
|
|
|
|
== UPGRADE ==
|
|
|
|
* Run sbin/testEnvironment.pl. WebGUI 8 adds new dependencies.
|
|
|
|
* Update wgd:
|
|
|
|
WebGUI has a new upgrades system for wgd to support. The old system silently
|
|
ignores the new upgrade scripts.
|
|
|
|
Get wgd from http://haarg.org/wgd, put in /data/wre/prereqs/bin/ (if you're
|
|
using the WRE), /usr/local/bin, or ~/bin.
|
|
|
|
Do chmod ugo+x wgd to make it executable.
|
|
|
|
* Run Upgrades:
|
|
|
|
$ wgd reset --upgrade
|
|
|
|
This is needed even for new WebGUI 8 installs. The create.sql and
|
|
WebGUI.conf.original are both from 7.10.x.
|
|
|
|
* Copy new "extras" (images, CSS, JavaScript) over:
|
|
|
|
$ rsync -r -a (or cp -a) /data/WebGUI/www/extras \
|
|
/data/domains/www.example.com/public/
|
|
|
|
* Add WebGUI's libraries to Perl's library path:
|
|
|
|
$ export PERL5LIB='/data/WebGUI/lib:/data/WebGUI/t/lib'
|
|
|
|
Previously, this would break Apache if it were set; now it's required for the
|
|
stuff plackup loads to find the rest of WebGUI.
|
|
|
|
* Launch WebGUI 8:
|
|
|
|
$ plackup app.psgi
|
|
|
|
... then connect your browser to the URL it advertises.
|
|
|
|
You'll be guided through a few quick questions to setup an admin account.
|
|
(Or, if you aren't but wanted to be, run wgd reset --starter to enable it.)
|
|
|
|
* Start Spectre:
|
|
|
|
cd /data/WebGUI/sbin
|
|
perl spectre.pl --daemon
|
|
|
|
|