##################################################################
#              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