Changed to reflect the new /setup/* method of install, setup and config.

doc/HOWTO.html

@@ -10,7 +10,7 @@
 <H1>  phpGroupWare HOWTO</H1>
 
 <H2>Joseph Engo &lt;jengo@phpgroupware.org&gt;,
-  Dan Kuykendall &lt;dan@kuykendall.org&gt;</H2>  v1.0, 7 July 2000
+  Dan Kuykendall &lt;dan@kuykendall.org&gt;</H2>  v1.1, 28 September 2000
 <P><HR>
 <EM>  This document explains how to install and configure phpGroupWare.</EM>
 <HR>
@@ -73,29 +73,23 @@ have the most recent development copy of phpGroupWare in no time.
 
 <P>After you have met the system requirements, unpack the tarball in the html 
 directory of your webserver. (eg, /home/httpd/html)
-<P>The first step is to setup the database and create the tables needed.  In the 
-doc directory there is a file called create_tables.(name of your database)
-<H3>Installation with MySQL</H3>
-
-<P>We will assume that you are using the database named phpgroupware.
-<P><CODE>$ mysql phpgroupware -u username -p &lt; create_tables.mysql</CODE>
-Then add the language entries (used for translation purposes).
-<P><CODE>$ mysql phpgroupware -u username -p &lt; lang.sql</CODE>
-<H3>Installation with PostgreSQL</H3>
-
-<P>We will assume that you are using the database named phpgroupware.
-<P><CODE>$ psql -d phpgroupware -U username &lt; create_tables.pgsql</CODE>
-Then add the language entries (used for translation purposes).
-<P><CODE>$ psql -d phpgroupware -U username &lt; lang.sql</CODE>
 <H2>2.5 Configure phpGroupWare</H2>
 
 <P>Copy the <CODE>header.inc.php.sample</CODE> file to 
 <CODE>header.inc.php</CODE> and edit the file, following the
 directions in the comments.
-<P>Change to the inc directory. <BR>
+<P>Then point your browser to phpgroupware/setup/ which will
-Copy <CODE>globalconfig.inc.php.sample</CODE> to <CODE>globalconfig.inc.php</CODE>
+create (or upgrade) the database tables. 
-and edit it to reflect your system settings, again following the
+You wil be asked to login, using the password set in
-comments in the file.
+<CODE>header.inc.php</CODE>. Setup will attempt to determine what version
+of the phpGroupWare database you have installed, and upgrade to the most recent
+version. 
+<P><B>NOTE:</B>The developers are concentrating on getting the beta
+working, and have not spent a great deal of time building upgrade scripts from the
+alpha versions of phpGroupWare. You are advised to backup your existing alpha
+database before running the setup script to avoid problems!
+<P>If you get no error messages, continue on to phpgroupware/setup/config.php 
+to configure phpGroupWare to your system.
 <P>If you are using the email system you will need to create a temporary directory 
 where file uploads will be stored.  For security reasons, you should <CODE>chown
 nobody.nobody</CODE> and <CODE>chmod 700</CODE> to that directory.  Depending on your system configuration.  
@@ -282,12 +276,13 @@ AddType             application/x-httpd-php .php3 .php
 <LI>Included the FAQ.</LI>
 <LI>Other minor additions.</LI>
 </UL>
-<P>v1.1 (September 27, 2000) - blinky
+<P>v1.1 (September 27-29, 2000) - blinky
 <P>
 <UL>
 <LI>Added Testing Install section</LI>
 <LI>Added Trouble-shooting section</LI>
 <LI>Added description of application installation</LI>
+<LI>Changes for the new setup program</LI>
 </UL>
 <H2>6.5 Copyrights and Trademarks </H2>
 

doc/HOWTO.sgml

@@ -10,9 +10,10 @@
   Dan Kuykendall <dan@kuykendall.org>
 </author>
 <date>
-  v1.0, 7 July 2000
+  v1.1, 28 September 2000
 </date>
 <abstract>
+<!-- $Id$ -->
   This document explains how to install and configure phpGroupWare.
 </abstract>
 
@@ -81,23 +82,6 @@ have the most recent development copy of phpGroupWare in no time.
 <p>
   After you have met the system requirements, unpack the tarball in the html 
   directory of your webserver. (eg, /home/httpd/html)
-  <p>
-  The first step is to setup the database and create the tables needed.  In the 
-  doc directory there is a file called create_tables.(name of your database)
-</p>
-<sect2>Installation with MySQL
-<p>
-  We will assume that you are using the database named phpgroupware.<p>
-  <tt>$ mysql phpgroupware -u username -p < create_tables.mysql</tt>
-  Then add the language entries (used for translation purposes).<p>
-  <tt>$ mysql phpgroupware -u username -p < lang.sql</tt>
-</p>
-<sect2>Installation with PostgreSQL
-<p>
-  We will assume that you are using the database named phpgroupware.<p>
-  <tt>$ psql -d phpgroupware -U username < create_tables.pgsql</tt>
-  Then add the language entries (used for translation purposes).<p>
-  <tt>$ psql -d phpgroupware -U username < lang.sql</tt>
 </p>
 <sect1>Configure phpGroupWare
 <p>
@@ -105,10 +89,20 @@ have the most recent development copy of phpGroupWare in no time.
   <tt>header.inc.php</tt> and edit the file, following the
   directions in the comments.
 <p>
-  Change to the inc directory. <newline>
+  Then point your browser to phpgroupware/setup/ which will
-  Copy <tt>globalconfig.inc.php.sample</tt> to <tt>globalconfig.inc.php</tt>
+  create (or upgrade) the database tables. 
-  and edit it to reflect your system settings, again following the
+  You wil be asked to login, using the password set in
-  comments in the file.
+  <tt>header.inc.php</tt>. Setup will attempt to determine what version
+  of the phpGroupWare database you have installed, and upgrade to the most recent
+  version. 
+
+<bf>NOTE:</bf>The developers are concentrating on getting the beta
+  working, and have not spent a great deal of time building upgrade scripts from the
+  alpha versions of phpGroupWare. You are advised to backup your existing alpha
+  database before running the setup script to avoid problems!
+
+  If you get no error messages, continue on to phpgroupware/setup/config.php 
+  to configure phpGroupWare to your system.
 <p>
   If you are using the email system you will need to create a temporary directory 
   where file uploads will be stored.  For security reasons, you should <tt>chown
@@ -304,13 +298,14 @@ name="http://sourceforge.net/mail/?group_id=7305">
 </itemize>
 </p>
 <p>
- v1.1 (September 27, 2000) - blinky
+ v1.1 (September 27-29, 2000) - blinky
 </p>
 <p>
 <itemize>
   <item>Added Testing Install section
   <item>Added Trouble-shooting section
   <item>Added description of application installation
+  <item>Changes for the new setup program
 </itemize>
 </p>
 <sect1>Copyrights and Trademarks 

doc/HOWTO.txt

@@ -1,7 +1,7 @@
   phpGroupWare HOWTO
   Joseph Engo <jengo@phpgroupware.org>, Dan Kuykendall
   <dan@kuykendall.org>
-  v1.0, 7 July 2000
+  v1.1, 28 September 2000
 
   This document explains how to install and configure phpGroupWare.
   ______________________________________________________________________
@@ -21,8 +21,6 @@
         2.3.1 Released Versions
         2.3.2 Developer's version from CVS
      2.4 Installing on Tested Systems
-        2.4.1 Installation with MySQL
-        2.4.2 Installation with PostgreSQL
      2.5 Configure phpGroupWare
 
   3. Testing the install
@@ -64,6 +62,8 @@
   phpGroupWare is a web based groupware application that includes
   integrated features such as email, calendar, todo list, address book,
   file manager, headline news, and a trouble ticket system.
+
+
   You should use it if:
 
   You would like a powerful groupware system that can be access from
@@ -126,37 +126,25 @@
   After you have met the system requirements, unpack the tarball in the
   html directory of your webserver. (eg, /home/httpd/html)
 
-  The first step is to setup the database and create the tables needed.
-  In the doc directory there is a file called create_tables.(name of
-  your database)
-
-  22..44..11..  IInnssttaallllaattiioonn wwiitthh MMyySSQQLL
-
-  We will assume that you are using the database named phpgroupware.
-
-  $ mysql phpgroupware -u username -p < create_tables.mysql Then add the
-  language entries (used for translation purposes).
-
-  $ mysql phpgroupware -u username -p < lang.sql
-
-  22..44..22..  IInnssttaallllaattiioonn wwiitthh PPoossttggrreeSSQQLL
-
-  We will assume that you are using the database named phpgroupware.
-
-  $ psql -d phpgroupware -U username < create_tables.pgsql Then add the
-  language entries (used for translation purposes).
-
-  $ psql -d phpgroupware -U username < lang.sql
-
   22..55..  CCoonnffiigguurree pphhppGGrroouuppWWaarree
 
   Copy the header.inc.php.sample file to header.inc.php and edit the
   file, following the directions in the comments.
+  Then point your browser to phpgroupware/setup/ which will create (or
+  upgrade) the database tables.  You wil be asked to login, using the
+  password set in header.inc.php. Setup will attempt to determine what
+  version of the phpGroupWare database you have installed, and upgrade
+  to the most recent version.
 
-  Change to the inc directory.
+  NNOOTTEE::The developers are concentrating on getting the beta working, and
-  Copy globalconfig.inc.php.sample to globalconfig.inc.php and edit it
+  have not spent a great deal of time building upgrade scripts from the
-  to reflect your system settings, again following the comments in the
+  alpha versions of phpGroupWare. You are advised to backup your
-  file.
+  existing alpha database before running the setup script to avoid
+  problems!
+
+  If you get no error messages, continue on to
+  phpgroupware/setup/config.php to configure phpGroupWare to your
+  system.
 
   If you are using the email system you will need to create a temporary
   directory where file uploads will be stored.  For security reasons,
@@ -196,6 +184,7 @@
   could add a few lines to logout.php that will look in the temp
   directory for any stale uploads and delete them.  But, once again, it
   becomes a performance issue.
+
   33..  TTeessttiinngg tthhee iinnssttaallll
 
   If your config is setup properly you can now login.  Point your
@@ -204,6 +193,9 @@
   At this point it would be a good idea to create a new user with
   administrative privileges and delete the old one.
 
+
+
+
   44..  IInnssttaalllliinngg aaddddiittiioonnaall aapppplliiccaattiioonnss
 
   Once you have the core phpGroupWare install up and running, you may
@@ -325,9 +317,6 @@
   IMAP if you expect to have more than a few hundred messages in your
   mailbox.
 
-
-
-
   55..33..  WWhheenn II lloogg iinn II sseeee tthhee ddiirreeccttoorryy lliissttiinngg iinnsstteeaadd ooff aa wweebb ppaaggee
 
   If you are using Apache, this often means you need to add .php to the
@@ -339,8 +328,6 @@
   DirectoryIndex index.php index.php3 index.html index.htm index.cgi
   ______________________________________________________________________
 
-
-
   55..44..  II ggeett ggaarrbbaaggee tthhaatt llooookkss lliikkee ccooddee wwhheenn II ggoo ttoo tthhee pphhppGGrroouuppWWaarree
   UURRLL
 
@@ -393,22 +380,24 @@
   v1.0 (July 6, 2000)
 
 
-
   +o  Built proper SGML version.
 
   +o  Included the FAQ.
 
   +o  Other minor additions.
 
-  v1.1 (September 27, 2000) - blinky
+  v1.1 (September 27-29, 2000) - blinky
 
 
   +o  Added Testing Install section
 
   +o  Added Trouble-shooting section
 
+
   +o  Added description of application installation
 
+  +o  Changes for the new setup program
+
   66..55..  CCooppyyrriigghhttss aanndd TTrraaddeemmaarrkkss
 
   Copyright (c)  Dan Kuykendall.  Permission is granted to copy,
@@ -448,6 +437,17 @@
 
 
 
+
+
+
+
+
+
+
+
+
+
+