Installation

Apache2::Request on SuSE 11.3
Getting Apache2::Request running on Suse 11 .
How To Configure a Static, non-WebGUI site
If you need to deploy a static-HTML, non-WebGUI site on a WebGUI WRE server, it's not too hard to do.
Installation Options
WebGUI is a very large application, and has many prerequisites. This can make installing WebGUI difficult for some people. We've tried to make the installation process easier for you by creating the WebGUI Runtime Enivoronment. We recommend using that to install WebGUI.
Installing WebGUI and WRE on a computer with no internet connection. (Manual Install of WebGUI using WRE)
Installing WebGUI on Debian
Install following Debian Packages before build WRE:
Installing WebGUI without root access
This is a guide to installing WebGUI (tested with v.7.7.20) from source as a user on Debian Lenny but it should work fine on other UNIX-like operating systems with a few modifications.
multiple perl installs
Just some notes about installing wre on a system that already has perl - NO GUARENTEES:
Running separate instance of apache with WRE
Let's define what we're going to accomplish. This will all be done on a working instance of WebGUI using the WRE ( try it on a dev server first so you're not breaking your live site while you play ). For this example I am using CentOS 5 with WRE 0.7.2 and WebGUI 7.3.22 already installed, up and running. Here are our goals: 1. Install the apache, php, and php-mysql packages using yum. 2. Configure this instance of apache to listen on port 82. 3. Configure mod_proxy apache in the WRE to send all of the traffic for a new domain (vhost) to our OS based apache, transparently to the end-user.
Source Install
Installing WebGUI from source is not a simple matter. If you have no experience installing open-source software you should either use the WebGUI Runtime Environment, seek professional assistance, or be prepared to run up against several hurdles. An experienced WebGUI installer can install WebGUI and all related components in about an hour. An experienced system administrator can expect to do it all in less than a day. Someone with no experience can expect to spend several days or even weeks reading and learning to install all of the required components of WebGUI. If you need help, please feel free to contact Plain Black.
Table of Contents
General WebGUI
Testing and Troubleshooting
Now it's time to test all of your labor to see if it all worked. The following tips are not meant to cover all possible installation and configuration problems that may occur, but rather to give you a shove in the right direction. If all else fails contact Plain Black under a support program for help.
The /data Partition
A lot of people ask us why we distribute WebGUI ready to be installed into a folder called /data. The answer is simple: experience. If you've ever been involved with a hosting environment you'll likely remember that servers were almost never upgraded once deployed. This was probably because it was just too difficult to do. There were files strewn around the filesystem and upgrading meant reinstalling all the server software. In addition, a lot of system administrators create a large RAID array to store all of their data. Administrators seem to have any name in the book as to what they will call these filesystems. Some we've seen are /data, /u1, /share, /bfd, /raid, and even /bigdog. Sometimes they'll use a name that already exists in the Linux filesystem like /usr, /usr/local, /var, or /opt. The problem with using a name in the filesystem is that your data is mixed in with operating system files. So we chose /data as our default partition name. Here are some of the advantages of using a /data partition:
Windows Installations
**Updated October 22, 2008: WebGUI is no longer supported on Windows. It is recommended that you use the VMWare Appliance for Windows installs (http://www.webgui.org/download).
WRE Troubleshooting
If you encounter errors with your WRE installation, here are some techniques to try when troubleshooting:
WRE-Building on FreeBSD 5.3
These are notes taken while building the WRE 0.7.2 from source inside a FreeBSD 5.3-RELEASE jail.