diff --git a/doc/HOWTO.html b/doc/HOWTO.html index fc99071aff..8b6d2c44dc 100644 --- a/doc/HOWTO.html +++ b/doc/HOWTO.html @@ -10,7 +10,7 @@

phpGroupWare HOWTO

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

v1.0, 7 July 2000 + Dan Kuykendall <dan@kuykendall.org> v1.1, 28 September 2000

This document explains how to install and configure phpGroupWare.
@@ -73,29 +73,23 @@ have the most recent development copy of phpGroupWare in no time.

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

Installation with MySQL

- -

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 -

Installation with PostgreSQL

- -

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

2.5 Configure phpGroupWare

Copy the header.inc.php.sample file to header.inc.php and edit the file, following the directions in the comments. -

Change to the inc directory.
-Copy globalconfig.inc.php.sample to globalconfig.inc.php -and edit it to reflect your system settings, again following the -comments in the file. +

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. +

NOTE: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.

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 chown nobody.nobody and chmod 700 to that directory. Depending on your system configuration. @@ -282,12 +276,13 @@ AddType application/x-httpd-php .php3 .php

  • Included the FAQ.
  • Other minor additions.
    • -

    v1.1 (September 27, 2000) - blinky +

    v1.1 (September 27-29, 2000) - blinky

    6.5 Copyrights and Trademarks

    diff --git a/doc/HOWTO.sgml b/doc/HOWTO.sgml index 9bd3b1b4e9..83101b10a9 100644 --- a/doc/HOWTO.sgml +++ b/doc/HOWTO.sgml @@ -10,9 +10,10 @@ Dan Kuykendall <dan@kuykendall.org> - v1.0, 7 July 2000 + v1.1, 28 September 2000 + This document explains how to install and configure phpGroupWare. @@ -81,23 +82,6 @@ have the most recent development copy of phpGroupWare in no time.

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

    -Installation with MySQL -

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

    -Installation with PostgreSQL -

    - 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

    Configure phpGroupWare

    @@ -105,10 +89,20 @@ have the most recent development copy of phpGroupWare in no time. header.inc.php and edit the file, following the directions in the comments.

    - Change to the inc directory. - Copy globalconfig.inc.php.sample to globalconfig.inc.php - and edit it to reflect your system settings, again following the - comments in the file. + 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. + +NOTE: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.

    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 chown @@ -304,13 +298,14 @@ name="http://sourceforge.net/mail/?group_id=7305">

    - v1.1 (September 27, 2000) - blinky + v1.1 (September 27-29, 2000) - blinky

    Added Testing Install section Added Trouble-shooting section Added description of application installation + Changes for the new setup program

    Copyrights and Trademarks diff --git a/doc/HOWTO.txt b/doc/HOWTO.txt index 9fe1bdff82..f75a7e4965 100644 --- a/doc/HOWTO.txt +++ b/doc/HOWTO.txt @@ -1,7 +1,7 @@ phpGroupWare HOWTO Joseph Engo , Dan Kuykendall - 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. - Copy globalconfig.inc.php.sample to globalconfig.inc.php and edit it - to reflect your system settings, again following the comments in the - file. + NNOOTTEE::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. 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 @@ + + + + + + + + + + +