From 4119c27bb4a97d497333108ff6f99e6a1680d062 Mon Sep 17 00:00:00 2001 From: sjb4891 Date: Wed, 18 Oct 2000 05:42:26 +0000 Subject: [PATCH] Minor fixes before 0.9.2 release --- doc/HOWTO.html | 98 +++++++++++++++++++++----- doc/HOWTO.sgml | 100 +++++++++++++++++++++++--- doc/HOWTO.txt | 186 ++++++++++++++++++++++++++++++++++++++++++------- 3 files changed, 331 insertions(+), 53 deletions(-) diff --git a/doc/HOWTO.html b/doc/HOWTO.html index 245b9eec50..1b0701da86 100644 --- a/doc/HOWTO.html +++ b/doc/HOWTO.html @@ -10,7 +10,8 @@

phpGroupWare HOWTO

Joseph Engo <jengo@phpgroupware.org>, - Dan Kuykendall <dan@kuykendall.org>

v1.1, 28 September 2000 + Dan Kuykendall <dan@kuykendall.org>, + Stephen Brown <blinky@phpgroupware.net> v1.3, 17 October 2000

This document explains how to install and configure phpGroupWare.
@@ -39,14 +40,18 @@ We will assume that you are running on a Linux or other Unix system for these st Windows is supported, but there is no documentation for it currently.

2.2 Tested Systems

-

On Linux 2.2.x +

Known compatible software

-

We have reports of phpGroupWare working on Windows NT and OS/2, and using Oracle as the database. +

Example configurations that the CVS versions have been up and running on are listed at the end of this document. +We have reports of phpGroupWare working on Windows NT and OS/2, and using Oracle as the database.

2.3 Obtaining phpGroupWare

While we are still in the Beta phase of phpGroupWare, you may @@ -71,8 +76,11 @@ Follow the directions for Anonymous CVS access and you should have the most recent development copy of phpGroupWare in no time.

2.4 Installing on Tested Systems

-

After you have met the system requirements, unpack the tarball in the html -directory of your webserver. (eg, /home/httpd/html) +

After you have met the additional software requirements (working DB, POP3/IMAP server, and PHP), +unpack the tarball in the html directory of your webserver. (eg, /home/httpd/html) +If you want the phpGroupWare install to appear at a URL other than +http://localhost/phpgroupware now is the time to rename the directory or move it +around under your document root.

2.5 Create a database and user for phpGroupWare

You must create a database for phpGroupWare to use, @@ -80,6 +88,37 @@ and we strongly recommend adding a user that only has permission to this new database for phpGroupWare's exclusive use (for security).

Note the host the database engine is on, user, password and database name, you will need them soon. +

Adding DB and users in MySQL

+ +

The quick stepse to get going on mysql are as follows (please consult the offical MySQL +documentation for the details). +

mysqladmin create phpgroupware - creates the blank database +

Go into the mysql command line utility with mysql mysql or use +a tool like phpMyAdmin to update the permission tables. +It is recommended that you add a user with no permissions, then +explicitly grant the user access to the phpgroupware database. +The following SQL is an example: +

+  insert into users(Host,User,Password) values('localhost','phpgwuser',PASSWORD('somethinghardtoguess');
+  insert into db(Host,DB,User,Select_priv,Insert_priv,Update_priv,Delete_priv,Create_priv,Drop_priv,Alter_priv)
+          values('localhost','phpgroupware','phpgwuser','Y','Y','Y','Y','Y','Y','Y')
+  
+
+ +you must then reload the grant tables with mysqladmin reload or refresh privledges from the mysql utility. +

PostgereSQL install

+ +

This is from gnrfan but has yet to be updated for the recent version of phpGroupWare, although +it should get you started. +

To start the postmaster just type at the console: +$postmaster -i -D /home/[username]/[dataDir] +Now if there is an error then is no datadir intitiated (assuming that postgreSQL is installed). +To do that you have to use initdb to create the dataDIR. Please look in +the documentation of posgreSQL or the manual page for initdb for details. +

If you have not encountered any error than you are ready to roll. +Now create a database which will be used by the phpGroupWare. +To do that type at the console: +$createdb phpgroupware assumming that you would name the database phpgroupware.

2.6 Configure phpGroupWare

Copy the header.inc.php.sample file to @@ -202,7 +241,7 @@ your mail server. If you change your password and it still isn't working, try logging out of phpGroupWare (the rightmost icon in the navigation bar) and then log back in.

An preference page to edit the email settings is being developed, and should -appear shortly after the first beta release. +appear shortly after the second beta release.

5.2 It seems to hang when I try to read my mail

This is often a problem if you are using POP3 instead of IMAP, and you have @@ -255,21 +294,42 @@ For PHP4: AddType application/x-httpd-php .php3 .php

-

6. About this document

+

6. Known working systems

-

6.1 New versions

+

A rough description of some of the hardware and software the developers have +used to develop phpGroupWare on, oh have confirmed working reports from people +in IRC. +

6.1 Seek3r has tested

+ +

phpGroupWare.org runs: +Red Hat 6.2, Apache/1.3.12,PHP/4.0.2,mod_perl/1.21,MySQL 3.23.10-alpha,Courier-IMAP 0.33+ with qmail 1.03 +

6.2 blinky has tested

+ +

phpGroupWare.net runs: +Red Hat 6.2,Apache/1.3.14 PHP/4.0.3pl1 mod_ssl/2.7.1 OpenSSL/0.9.6 PHP4.03.pl1,MySQL 3.23.10-alpha,qmail 1.03 +

dev boxes are variants on: +Red Hat 7.0,mysql-3.23.22-6 (from RH7 RPM), and Sendmail, Courier, or qmail+courier IMAP depending on mood. +

6.3 Jengo has tested

+ +

main test box: Red Hat 6.2,Apache/1.3.12,PHP 3.0.16,PostgreSQL 7.2,Sendmail (from RH6.2) +

laptop is rh 6.1, apache 1.3.?, MySQL and PostgreSQL 7.0 w/ PHP 3.0.16, its a P-90 w/ 40 mb ram and a 800 mb hd +

+Also, confirmation through IRC of phpGroupware working on Win2k with IIS5.0, PHP4.0.2 and MySQL just recently +

7. About this document

+ +

7.1 New versions

The newest version of this document can be found on our website http://www.phpgroupware.org as SGML source, HTML, or TEXT. -

6.2 Comments

+

7.2 Comments

Comments on this HOWTO should be directed to the phpGroupWare developers mailing list phpgroupware-developers@lists.sourceforge.net.

To subscribe, go to -http://sourceforge.net/mail/?group_id=7305

6.3 History

+http://sourceforge.net/mail/?group_id=7305

7.3 History

This document was started by Joseph Engo and reworked by Dan Kuykendall. -

6.4 Version History

+

7.4 Version History

Old Version

@@ -291,7 +351,13 @@ AddType application/x-httpd-php .php3 .php

  • Added description of application installation
  • Changes for the new setup program
    • -

    6.5 Copyrights and Trademarks

    +

    v1.2 (Early October 2000) - blinky +

    +

    +

    7.5 Copyrights and Trademarks

    Copyright (c) Dan Kuykendall. Permission is granted to copy, distribute and/or modify this document @@ -299,7 +365,7 @@ under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation

    A copy of the license is available at GNU Free Documentation License. -

    6.6 Acknowledgments and Thanks

    +

    7.6 Acknowledgments and Thanks

    Thanks to Joesph Engo for starting phpGroupWare (at the time called webdistro) and the core of this HOWTO. Thanks to all the developers and users who contribute to making phpGroupWare such a success. diff --git a/doc/HOWTO.sgml b/doc/HOWTO.sgml index a033c13506..100018773a 100644 --- a/doc/HOWTO.sgml +++ b/doc/HOWTO.sgml @@ -1,16 +1,18 @@ - +

    phpGroupWare HOWTO Joseph Engo <jengo@phpgroupware.org>, - Dan Kuykendall <dan@kuykendall.org> + Dan Kuykendall <dan@kuykendall.org>, + Stephen Brown <blinky@phpgroupware.net> - v1.1, 28 September 2000 + v1.3, 17 October 2000 @@ -45,14 +47,18 @@

    Tested Systems

    - On Linux 2.2.x + Known compatible software - PHP 3.0.15+ / PHP 4.0.x + PHP 3.0.15+ or PHP 4.0.x (preferred) Apache 1.3.x - MySQL 3.22.25 or PostgreSQL 7.0.x - Courier-IMAP 0.33+ and/or qmail 1.03 for POP3 access + MySQL 3.22.25 or greater + MySQL 3.23.10 or greater + Courier IMAP 0.33+ for IMAP (optionally with vmailmgr) + qmail 1.03 for SMTP and POP + sendmail for SMTP + Example configurations that the CVS versions have been up and running on are listed at the end of this document. We have reports of phpGroupWare working on Windows NT and OS/2, and using Oracle as the database.

    Obtaining phpGroupWare @@ -80,8 +86,11 @@ have the most recent development copy of phpGroupWare in no time. Installing on Tested Systems

    - After you have met the system requirements, unpack the tarball in the html - directory of your webserver. (eg, /home/httpd/html) + After you have met the additional software requirements (working DB, POP3/IMAP server, and PHP), + unpack the tarball in the html directory of your webserver. (eg, /home/httpd/html) + If you want the phpGroupWare install to appear at a URL other than + http://localhost/phpgroupware now is the time to rename the directory or move it + around under your document root.

    Create a database and user for phpGroupWare

    @@ -91,6 +100,40 @@ have the most recent development copy of phpGroupWare in no time. exclusive use (for security). Note the host the database engine is on, user, password and database name, you will need them soon. + Adding DB and users in MySQL +

    The quick stepse to get going on mysql are as follows (please consult the offical MySQL + documentation for the details). + + mysqladmin create phpgroupware - creates the blank database + + Go into the mysql command line utility with mysql mysql or use + a tool like phpMyAdmin to update the permission tables. + It is recommended that you add a user with no permissions, then + explicitly grant the user access to the phpgroupware database. + The following SQL is an example: + + insert into users(Host,User,Password) values('localhost','phpgwuser',PASSWORD('somethinghardtoguess'); + insert into db(Host,DB,User,Select_priv,Insert_priv,Update_priv,Delete_priv,Create_priv,Drop_priv,Alter_priv) + values('localhost','phpgroupware','phpgwuser','Y','Y','Y','Y','Y','Y','Y') + + you must then reload the grant tables with mysqladmin reload or refresh privledges from the mysql utility. +

    + PostgereSQL install +

    + This is from gnrfan but has yet to be updated for the recent version of phpGroupWare, although + it should get you started. + + To start the postmaster just type at the console: + $postmaster -i -D /home/[username]/[dataDir] + Now if there is an error then is no datadir intitiated (assuming that postgreSQL is installed). + To do that you have to use initdb to create the dataDIR. Please look in + the documentation of posgreSQL or the manual page for initdb for details. + + If you have not encountered any error than you are ready to roll. + Now create a database which will be used by the phpGroupWare. + To do that type at the console: + $createdb phpgroupware assumming that you would name the database phpgroupware. +

    Configure phpGroupWare

    Copy the header.inc.php.sample file to @@ -224,7 +267,7 @@ try logging out of phpGroupWare (the rightmost icon in the navigation bar) and then log back in. An preference page to edit the email settings is being developed, and should -appear shortly after the first beta release. +appear shortly after the second beta release.

    It seems to hang when I try to read my mail @@ -271,6 +314,34 @@ For PHP4: AddType application/x-httpd-php .php3 .php

    +Known working systems +

    + A rough description of some of the hardware and software the developers have + used to develop phpGroupWare on, oh have confirmed working reports from people + in IRC. +

    + Seek3r has tested +

    + phpGroupWare.org runs: + Red Hat 6.2, Apache/1.3.12,PHP/4.0.2,mod_perl/1.21,MySQL 3.23.10-alpha,Courier-IMAP 0.33+ with qmail 1.03 +

    + blinky has tested +

    + phpGroupWare.net runs: + Red Hat 6.2,Apache/1.3.14 PHP/4.0.3pl1 mod_ssl/2.7.1 OpenSSL/0.9.6 PHP4.03.pl1,MySQL 3.23.10-alpha,qmail 1.03 + + dev boxes are variants on: + Red Hat 7.0,mysql-3.23.22-6 (from RH7 RPM), and Sendmail, Courier, or qmail+courier IMAP depending on mood. +

    + Jengo has tested +

    + main test box: Red Hat 6.2,Apache/1.3.12,PHP 3.0.16,PostgreSQL 7.2,Sendmail (from RH6.2) + + laptop is rh 6.1, apache 1.3.?, MySQL and PostgreSQL 7.0 w/ PHP 3.0.16, its a P-90 w/ 40 mb ram and a 800 mb hd +

    +

    + Also, confirmation through IRC of phpGroupware working on Win2k with IIS5.0, PHP4.0.2 and MySQL just recently +

    About this document New versions

    @@ -316,6 +387,15 @@ name="http://sourceforge.net/mail/?group_id=7305"> Changes for the new setup program

    +

    + v1.2 (Early October 2000) - blinky +

    +

    + + Info about creatign MySQL DB and user + Partial PostgreSQL info from gnrfan + +

    Copyrights and Trademarks

    Copyright (c) Dan Kuykendall. diff --git a/doc/HOWTO.txt b/doc/HOWTO.txt index 1d87c957eb..f33917ed88 100644 --- a/doc/HOWTO.txt +++ b/doc/HOWTO.txt @@ -1,7 +1,8 @@ phpGroupWare HOWTO Joseph Engo , Dan Kuykendall - - v1.1, 28 September 2000 + , Stephen Brown + v1.3, 17 October 2000 This document explains how to install and configure phpGroupWare. ______________________________________________________________________ @@ -22,6 +23,8 @@ 2.3.2 Developer's version from CVS 2.4 Installing on Tested Systems 2.5 Create a database and user for phpGroupWare + 2.5.1 Adding DB and users in MySQL + 2.5.2 PostgereSQL install 2.6 Configure phpGroupWare 3. Testing the install @@ -35,14 +38,20 @@ 5.3 When I log in I see the directory listing instead of a web page 5.4 I get garbage that looks like code when I go to the phpGroupWare URL - 6. About this document + 6. Known working systems - 6.1 New versions - 6.2 Comments - 6.3 History - 6.4 Version History - 6.5 Copyrights and Trademarks - 6.6 Acknowledgments and Thanks + 6.1 Seek3r has tested + 6.2 blinky has tested + 6.3 Jengo has tested + + 7. About this document + + 7.1 New versions + 7.2 Comments + 7.3 History + 7.4 Version History + 7.5 Copyrights and Trademarks + 7.6 Acknowledgments and Thanks ______________________________________________________________________ @@ -55,7 +64,6 @@ It should run on all systems where PHP is available and currently supports MySQL and PostgreSQL. - 11..11.. WWhhaatt iiss pphhppGGrroouuppWWaarree aanndd wwhhyy sshhoouulldd II uussee iitt?? phpGroupWare is: @@ -64,6 +72,7 @@ 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 @@ -85,18 +94,26 @@ 22..22.. TTeesstteedd SSyysstteemmss - On Linux 2.2.x + Known compatible software - +o PHP 3.0.15+ / PHP 4.0.x + +o PHP 3.0.15+ or PHP 4.0.x (preferred) +o Apache 1.3.x - +o MySQL 3.22.25 or PostgreSQL 7.0.x + +o MySQL 3.22.25 or greater - +o Courier-IMAP 0.33+ and/or qmail 1.03 for POP3 access + +o MySQL 3.23.10 or greater - We have reports of phpGroupWare working on Windows NT and OS/2, and - using Oracle as the database. + +o Courier IMAP 0.33+ for IMAP (optionally with vmailmgr) + + +o qmail 1.03 for SMTP and POP + + +o sendmail for SMTP + + Example configurations that the CVS versions have been up and running + on are listed at the end of this document. We have reports of + phpGroupWare working on Windows NT and OS/2, and using Oracle as the + database. 22..33.. OObbttaaiinniinngg pphhppGGrroouuppWWaarree @@ -111,6 +128,8 @@ contains links to the most recent releases, and several mirror sites for the releases. + + 22..33..22.. DDeevveellooppeerr''ss vveerrssiioonn ffrroomm CCVVSS If you have never used CVS, you may want to read through the @@ -123,8 +142,12 @@ 22..44.. IInnssttaalllliinngg oonn TTeesstteedd SSyysstteemmss - After you have met the system requirements, unpack the tarball in the - html directory of your webserver. (eg, /home/httpd/html) + After you have met the additional software requirements (working DB, + POP3/IMAP server, and PHP), unpack the tarball in the html directory + of your webserver. (eg, /home/httpd/html) If you want the phpGroupWare + install to appear at a URL other than http://localhost/phpgroupware + now is the time to rename the directory or move it around under your + document root. 22..55.. CCrreeaattee aa ddaattaabbaassee aanndd uusseerr ffoorr pphhppGGrroouuppWWaarree @@ -135,6 +158,49 @@ Note the host the database engine is on, user, password and database name, you will need them soon. + 22..55..11.. + + AAddddiinngg DDBB aanndd uusseerrss iinn MMyySSQQLL + + The quick stepse to get going on mysql are as follows (please consult + the offical MySQL documentation for the details). + + mysqladmin create phpgroupware - creates the blank database + + Go into the mysql command line utility with mysql mysql or use a tool + like phpMyAdmin to update the permission tables. It is recommended + that you add a user with no permissions, then explicitly grant the + user access to the phpgroupware database. The following SQL is an + example: + + insert into users(Host,User,Password) values('localhost','phpgwuser',PASSWORD('somethinghardtoguess'); + insert into db(Host,DB,User,Select_priv,Insert_priv,Update_priv,Delete_priv,Create_priv,Drop_priv,Alter_priv) + values('localhost','phpgroupware','phpgwuser','Y','Y','Y','Y','Y','Y','Y') + + + + you must then reload the grant tables with mysqladmin reload or + refresh privledges from the mysql utility. + + 22..55..22.. + + PPoossttggeerreeSSQQLL iinnssttaallll + + This is from gnrfan but has yet to be updated for the recent version + of phpGroupWare, although it should get you started. + + To start the postmaster just type at the console: $postmaster -i -D + /home/[username]/[dataDir] Now if there is an error then is no datadir + intitiated (assuming that postgreSQL is installed). To do that you + have to use initdb to create the dataDIR. Please look in the + documentation of posgreSQL or the manual page for initdb for details. + + + If you have not encountered any error than you are ready to roll. Now + create a database which will be used by the phpGroupWare. To do that + type at the console: $createdb phpgroupware assumming that you would + name the database phpgroupware. + 22..66.. CCoonnffiigguurree pphhppGGrroouuppWWaarree Copy the header.inc.php.sample file to header.inc.php and edit the @@ -292,7 +358,7 @@ bar) and then log back in. An preference page to edit the email settings is being developed, and - should appear shortly after the first beta release. + should appear shortly after the second beta release. 55..22.. IItt sseeeemmss ttoo hhaanngg wwhheenn II ttrryy ttoo rreeaadd mmyy mmaaiill @@ -362,14 +428,53 @@ - 66.. AAbboouutt tthhiiss ddooccuummeenntt + 66.. KKnnoowwnn wwoorrkkiinngg ssyysstteemmss - 66..11.. NNeeww vveerrssiioonnss + A rough description of some of the hardware and software the + developers have used to develop phpGroupWare on, oh have confirmed + working reports from people in IRC. + + 66..11.. + + SSeeeekk33rr hhaass tteesstteedd + + phpGroupWare.org runs: Red Hat 6.2, + Apache/1.3.12,PHP/4.0.2,mod_perl/1.21,MySQL 3.23.10-alpha,Courier-IMAP + 0.33+ with qmail 1.03 + + 66..22.. + + bblliinnkkyy hhaass tteesstteedd + + phpGroupWare.net runs: Red Hat 6.2,Apache/1.3.14 PHP/4.0.3pl1 + mod_ssl/2.7.1 OpenSSL/0.9.6 PHP4.03.pl1,MySQL 3.23.10-alpha,qmail 1.03 + + dev boxes are variants on: Red Hat 7.0,mysql-3.23.22-6 (from RH7 RPM), + and Sendmail, Courier, or qmail+courier IMAP depending on mood. + + 66..33.. + + JJeennggoo hhaass tteesstteedd + + main test box: Red Hat 6.2,Apache/1.3.12,PHP 3.0.16,PostgreSQL + 7.2,Sendmail (from RH6.2) + + + laptop is rh 6.1, apache 1.3.?, MySQL and PostgreSQL 7.0 w/ PHP + 3.0.16, its a P-90 w/ 40 mb ram and a 800 mb hd + + + Also, confirmation through IRC of phpGroupware working on Win2k with + IIS5.0, PHP4.0.2 and MySQL just recently + + 77.. AAbboouutt tthhiiss ddooccuummeenntt + + 77..11.. NNeeww vveerrssiioonnss The newest version of this document can be found on our website as SGML source, HTML, or TEXT. - 66..22.. CCoommmmeennttss + 77..22.. CCoommmmeennttss Comments on this HOWTO should be directed to the phpGroupWare developers mailing list phpgroupware-developers@lists.sourceforge.net @@ -378,12 +483,12 @@ To subscribe, go to http://sourceforge.net/mail/?group_id=7305 - 66..33.. HHiissttoorryy + 77..33.. HHiissttoorryy This document was started by Joseph Engo and reworked by Dan Kuykendall. - 66..44.. VVeerrssiioonn HHiissttoorryy + 77..44.. VVeerrssiioonn HHiissttoorryy Old Version @@ -393,7 +498,6 @@ v1.0 (July 6, 2000) - +o Built proper SGML version. +o Included the FAQ. @@ -411,7 +515,14 @@ +o Changes for the new setup program - 66..55.. CCooppyyrriigghhttss aanndd TTrraaddeemmaarrkkss + v1.2 (Early October 2000) - blinky + + + +o Info about creatign MySQL DB and user + + +o Partial PostgreSQL info from gnrfan + + 77..55.. CCooppyyrriigghhttss aanndd TTrraaddeemmaarrkkss Copyright (c) Dan Kuykendall. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free @@ -421,7 +532,7 @@ A copy of the license is available at GNU Free Documentation License . - 66..66.. AAcckknnoowwlleeddggmmeennttss aanndd TThhaannkkss + 77..66.. AAcckknnoowwlleeddggmmeennttss aanndd TThhaannkkss Thanks to Joesph Engo for starting phpGroupWare (at the time called webdistro) and the core of this HOWTO. Thanks to all the developers @@ -446,6 +557,27 @@ + + + + + + + + + + + + + + + + + + + + +