getting there with the mp2 handlers

docs/changelog/6.x.x.txt

@@ -1,7 +1,12 @@
 6.8.0
  - Switched Date::Manip to DateTime for better performance and more 
    functionality. See gotchas for details. In our benchmarks DateTime runs 
-   about 13 times faster than Date::Manip.
+   about 13 times faster than Date::Manip. Depending upon how date intensive
+   your pages are, you will see a 2% to 100% performance increase from this
+   change.
+ - Switched from Apache::Registry/CGI to a pure mod_perl2 interface, which
+   increased performance by over 70% to the entire system, and in some cases
+   as much as 100%. See gotcha.txt for details.
 
 
 6.7.7

docs/gotcha.txt

@@ -22,6 +22,53 @@ save you many hours of grief.
 	no longer need date caching so the enableDateCache directive can
 	be removed from your config file.
 
+ * WebGUI now requires Apache2 with mod_perl2 so CGI, FastCGI, PerlEx,
+	although never officially supported, are no longer possible.
+	Making this change gave us more than 70% performance improvement
+	and opens up even more possibilities for performance and other
+	optimizations.
+
+	You'll need to make the following changes in Apache to upgrade
+	to this release:
+
+	Install libaprereq2. You can either download and compile this
+	from the mod_perl web site, CPAN as Apache2::Request, or by
+	getting the version of the WRE 0.6.0 or higher.
+
+	Edit your httpd.conf or httpd.modperl.conf and add the following
+	directives to your global server config:
+
+  	LoadModule apreq_module modules/mod_apreq2.so
+ 	PerlSetVar WebguiRoot /data/WebGUI
+
+	You may also remove this block if you have it:
+
+	<Files ~ "\.(pl)$">
+    		SetHandler perl-script
+    		PerlHandler ModPerl::Registry::handler
+    		PerlOptions +ParseHeaders
+	</Files>
+
+	Edit each of your virtual hosts and add the following directives,
+	changing them to suit your needs:
+
+	SetHandler perl-script
+        PerlInitHandler WebGUI
+        PerlSetVar WebguiConfig www.example.com.conf
+
+	If you were using mod rewrite you'll need to adjust your rules
+	because they no longer need to remove the gateway (index.pl)
+	from the URL.
+
+	If you were using the uploadsAccessHandler.perl you no longer
+	need that as it is built in to the WebGUI handler.
+
+	For more information consult the WebGUI Done Right documentation.
+
+ * WebGUI now requires MySQL 5.0 to operate. This is due to the huge
+	number of new features afforded us in the MySQL 5.0 database,
+	which will increase performance, and add to our functionality
+	for the future.
 
 
 6.7.0

docs/install.txt

@@ -10,14 +10,29 @@ documentation.
 
 QnD INSTALL INSTRUCTIONS:
 
-1. Install Perl 5.6.x or greater. (5.8.x recommended)
+1. Install Perl 5.8 or higher.
 
-2. Install Apache with mod_perl and set up your config. See Ruling WebGUI
-   for information specific to Apache 1.3 vs 2.0. Apache 2 recommended.
+2. Install Apache 2.0 with mod_perl 2.0 and set up your config. Add the
+following directives to mod_perl (See WebGUI Done Right for more detail.)
 
-3. Install MySQL 3.23 or greater. MySQL 4.1 recommended.
+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
 
-4. Install Image Magick.
+<VirtualHost *:80>
+        ServerName www.example.com 
+        ServerAlias example.com
+        DocumentRoot /data/domains/example.com/www/public
+        SetHandler perl-script
+        PerlInitHandler WebGUI
+        PerlSetVar WebguiConfig www.example.com.conf
+</VirtualHost>
+
+3. Install MySQL 5.0 or higher.
+
+4. Install Image Magick 6.0 or higher.
 
 5. Extract WebGUI into your webroot.
 

docs/migration.txt

@@ -489,3 +489,11 @@ therefore removed them. This shouldn't affect almost anybody, but we're
 mentioning it just in case you're using WebGUI::DateTime in an odd mannner.
 They are: epochToDate, dateToEpoch, epochToArray, arrayToEpoch
 
+
+5.22 CGI No Longer
+
+As of 6.8.0 we are no longer using CGI to handle our web interactions. Instead
+we are using a native mod perl handler. If you used $session{cgi} object
+you'll now need to convert your applications to use the methods provided by
+Apache2::Request which is referenced through $session{modperl}.
+

docs/upgrades/upgrade_6.7.8-6.8.0.pl

@@ -12,22 +12,28 @@ my $quiet;
 
 start();
 addTimeZonesToUserPreferences();
-
 #TODO (by somebody!):
 # possibly instead of deleting old user timeZone preferences, convert them.
 # MUST DO: any dates in WebGUI greater than epoch 2^32 must be reduced, because
 # the new DateTime system uses Params::Validate, which will only validate integers
 # up to 2^32 as SCALARs. :(
-
-
+removeUnneededFiles();
 finish();
 
 #-------------------------------------------------
 sub addTimeZonesToUserPreferences {
+	print "\tDropping time offsets in favor of time zones.\n" unless ($quiet);
 	WebGUI::SQL->write("delete from userProfileData where fieldName='timeOffset'");
 	WebGUI::SQL->write("update userProfileField set dataValues='', fieldName='timeZone', dataType='timeZone', dataDefault=".quote("['America/Chicago']")." where fieldName='timeOffset'");
 }
 
+sub removeUnneededFiles {
+	print "\tRemoving files that are no longer needed.\n" unless ($quiet);
+	unlink("../../www/env.pl");
+	unlink("../../www/index.fpl");
+	unlink("../../www/index.pl");
+}
+
 #--- DO NOT EDIT BELOW THIS LINE
 
 #-------------------------------------------------