mirror of
https://github.com/EGroupware/egroupware.git
synced 2024-12-22 14:41:29 +01:00
updated doc directory to conform with new docteam standard
This commit is contained in:
brandonne
parent
5bb76f2110
commit
63a956e5df
@ -1 +1,5 @@
|
|||||||
See the CHANGELOG in phpgwapi/doc
|
12/29/2001
|
||||||
|
added en_US directory and installed SGML versions of the documentation.
|
||||||
|
adjusted directories to conform to the new documentation standard.
|
||||||
|
|
||||||
|
-Brandon-
|
||||||
|
|||||||
22
doc/Makefile
22
doc/Makefile
@ -1,21 +1 @@
|
|||||||
|
# To be completed in the near future
|
||||||
TOP = index
|
|
||||||
|
|
||||||
all : $(TOP).ps $(TOP).txt
|
|
||||||
|
|
||||||
$(TOP).tex: $(TOP).lyx
|
|
||||||
lyx --export latex $(TOP).lyx
|
|
||||||
|
|
||||||
$(TOP).dvi: $(TOP).tex
|
|
||||||
latex $(TOP).tex
|
|
||||||
|
|
||||||
$(TOP).ps: $(TOP).dvi
|
|
||||||
dvips -o $@ $(TOP).dvi
|
|
||||||
|
|
||||||
$(TOP).txt: $(TOP).lyx
|
|
||||||
lyx --export text $(TOP).lyx
|
|
||||||
|
|
||||||
clean:
|
|
||||||
rm ./$(TOP).toc; rm ./$(TOP).aux; rm ./$(TOP).tex; rm ./$(TOP).log
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
@ -1,18 +1,6 @@
|
|||||||
These installation docs are created using lyx on
|
The documentation is writtend in DocBook SGML and converted to other formats use Jade.
|
||||||
a linux system.
|
|
||||||
|
|
||||||
The makefile in this directory will generate the various other
|
The makefile in this directory is used to generate the various other forms on the docs server, it may or may not work on your particular installation.
|
||||||
forms of the installation docs i.e. html, pdf, ps etc.
|
|
||||||
In order to use the Makefile you need to have the following installed
|
|
||||||
and in your path:
|
|
||||||
|
|
||||||
lyx (1.1.6fix1)
|
|
||||||
latex2html
|
|
||||||
dvips
|
|
||||||
pdflatex
|
|
||||||
|
|
||||||
|
|
||||||
--Darryl VanDorp
|
|
||||||
aka ||Maniac
|
|
||||||
|
|
||||||
|
--Brandon Neill
|
||||||
|
|
||||||
|
|||||||
@ -1,2 +0,0 @@
|
|||||||
|
|
||||||
|
|
||||||
778
doc/index.html
778
doc/index.html
@ -1,778 +0,0 @@
|
|||||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
||||||
|
|
||||||
<!--Converted with LaTeX2HTML 99.2beta8 (1.42)
|
|
||||||
original version by: Nikos Drakos, CBLU, University of Leeds
|
|
||||||
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
|
|
||||||
* with significant contributions from:
|
|
||||||
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
|
|
||||||
<HTML>
|
|
||||||
<HEAD>
|
|
||||||
<TITLE>phpGroupWare Docs</TITLE>
|
|
||||||
<META NAME="description" CONTENT="phpGroupWare Docs">
|
|
||||||
<META NAME="keywords" CONTENT="index">
|
|
||||||
<META NAME="resource-type" CONTENT="document">
|
|
||||||
<META NAME="distribution" CONTENT="global">
|
|
||||||
|
|
||||||
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
|
|
||||||
<META NAME="Generator" CONTENT="LaTeX2HTML v99.2beta8">
|
|
||||||
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
|
|
||||||
|
|
||||||
<LINK REL="STYLESHEET" HREF="index.css">
|
|
||||||
|
|
||||||
</HEAD>
|
|
||||||
|
|
||||||
<BODY >
|
|
||||||
<!--Navigation Panel-->
|
|
||||||
<IMG WIDTH="81" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next_inactive"
|
|
||||||
SRC="file:/usr/lib/latex2html/icons/nx_grp_g.png">
|
|
||||||
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
|
|
||||||
SRC="file:/usr/lib/latex2html/icons/up_g.png">
|
|
||||||
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
|
|
||||||
SRC="file:/usr/lib/latex2html/icons/prev_g.png">
|
|
||||||
<BR>
|
|
||||||
<BR>
|
|
||||||
<BR>
|
|
||||||
<!--End of Navigation Panel-->
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
<H1 ALIGN="CENTER"><B>phpGroupWare Installation</B></H1>
|
|
||||||
<P ALIGN="CENTER"><STRONG>Editor: Darryl VanDorp</STRONG></P>
|
|
||||||
$Id$
|
|
||||||
|
|
||||||
<P>
|
|
||||||
<BR>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00010000000000000000">
|
|
||||||
Contents</A>
|
|
||||||
</H2>
|
|
||||||
<!--Table of Contents-->
|
|
||||||
|
|
||||||
<UL>
|
|
||||||
<LI><A NAME="tex2html27"
|
|
||||||
HREF="index.html">Contents</A>
|
|
||||||
<LI><A NAME="tex2html28"
|
|
||||||
HREF="index.html#SECTION00020000000000000000">Dedication </A>
|
|
||||||
<LI><A NAME="tex2html29"
|
|
||||||
HREF="index.html#SECTION00030000000000000000">1 What is phpGroupWare </A>
|
|
||||||
<LI><A NAME="tex2html30"
|
|
||||||
HREF="index.html#SECTION00040000000000000000">2 Why you should use it </A>
|
|
||||||
<LI><A NAME="tex2html31"
|
|
||||||
HREF="index.html#SECTION00050000000000000000">3 Installation</A>
|
|
||||||
<UL>
|
|
||||||
<LI><A NAME="tex2html32"
|
|
||||||
HREF="index.html#SECTION00051000000000000000">3.1 Requirements </A>
|
|
||||||
<LI><A NAME="tex2html33"
|
|
||||||
HREF="index.html#SECTION00052000000000000000">3.2 Tested Systems </A>
|
|
||||||
</UL>
|
|
||||||
<LI><A NAME="tex2html34"
|
|
||||||
HREF="index.html#SECTION00060000000000000000">4 Obtaining and Installing phpGroupWare </A>
|
|
||||||
<UL>
|
|
||||||
<LI><A NAME="tex2html35"
|
|
||||||
HREF="index.html#SECTION00061000000000000000">4.1 Installing from TarBall </A>
|
|
||||||
<LI><A NAME="tex2html36"
|
|
||||||
HREF="index.html#SECTION00062000000000000000">4.2 Installing from CVS </A>
|
|
||||||
<LI><A NAME="tex2html37"
|
|
||||||
HREF="index.html#SECTION00063000000000000000">4.3 Setting File Permissions </A>
|
|
||||||
<LI><A NAME="tex2html38"
|
|
||||||
HREF="index.html#SECTION00064000000000000000">4.4 Setup the database</A>
|
|
||||||
<LI><A NAME="tex2html39"
|
|
||||||
HREF="index.html#SECTION00065000000000000000">4.5 Setup / Configure phpGroupWare </A>
|
|
||||||
<LI><A NAME="tex2html40"
|
|
||||||
HREF="index.html#SECTION00066000000000000000">4.6 Testing the install </A>
|
|
||||||
<LI><A NAME="tex2html41"
|
|
||||||
HREF="index.html#SECTION00067000000000000000">4.7 Installing additional applications </A>
|
|
||||||
</UL>
|
|
||||||
<LI><A NAME="tex2html42"
|
|
||||||
HREF="index.html#SECTION00070000000000000000">5 Trouble Shooting</A>
|
|
||||||
<UL>
|
|
||||||
<LI><A NAME="tex2html43"
|
|
||||||
HREF="index.html#SECTION00071000000000000000">5.1 It seems to hang when I try to read my mail </A>
|
|
||||||
<LI><A NAME="tex2html44"
|
|
||||||
HREF="index.html#SECTION00072000000000000000">5.2 When I log in I see the directory listing instead of a web page </A>
|
|
||||||
<LI><A NAME="tex2html45"
|
|
||||||
HREF="index.html#SECTION00073000000000000000">5.3 I get garbage that looks like code when I go to the phpGroupWare
|
|
||||||
URL </A>
|
|
||||||
</UL>
|
|
||||||
<LI><A NAME="tex2html46"
|
|
||||||
HREF="index.html#SECTION00080000000000000000">6 About this document</A>
|
|
||||||
<UL>
|
|
||||||
<LI><A NAME="tex2html47"
|
|
||||||
HREF="index.html#SECTION00081000000000000000">6.1 History </A>
|
|
||||||
<LI><A NAME="tex2html48"
|
|
||||||
HREF="index.html#SECTION00082000000000000000">6.2 Version History </A>
|
|
||||||
</UL>
|
|
||||||
<LI><A NAME="tex2html49"
|
|
||||||
HREF="index.html#SECTION00090000000000000000">About this document ...</A>
|
|
||||||
</UL>
|
|
||||||
<!--End of Table of Contents-->
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00020000000000000000">
|
|
||||||
Dedication </A>
|
|
||||||
</H1>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
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.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00030000000000000000">
|
|
||||||
1 What is phpGroupWare </A>
|
|
||||||
</H1>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
phpGroupWare is a web based GroupWare system. It comes with serveral
|
|
||||||
core apps for email, calendar, todo list, address book, file manager,
|
|
||||||
and a notepad.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
It also provides a framework for add-on applications to integrate
|
|
||||||
seamlessly in phpGroupWare. Some samples are a bookmark manager, a
|
|
||||||
trouble ticket system, a weather reporter, a phone log, a chat program,
|
|
||||||
and a forum system. There are many more in development, and you can
|
|
||||||
develop your own as well.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00040000000000000000">
|
|
||||||
2 Why you should use it </A>
|
|
||||||
</H1>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You should use it if you would like a powerful groupware system that
|
|
||||||
can be access from anywhere on the Internet, and allows for custom
|
|
||||||
add-ons. For companies with a distributed user base, it's an ideal
|
|
||||||
solution. Oh, and did I mention that its FREE?
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00050000000000000000">
|
|
||||||
3 Installation</A>
|
|
||||||
</H1>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Installation and Configuration of phpGroupWare has never been easier.
|
|
||||||
Just point and click, yeah it's very easy.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Since this is still a beta version we do expect some bugs. By carefully
|
|
||||||
reading this document you can easly install phpGroupWare.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00051000000000000000">
|
|
||||||
3.1 Requirements </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You will need PHP compiled and installed on your system. You will
|
|
||||||
also need MySQL or PostgreSQL setup. If you are planning on using
|
|
||||||
the email system, you will need to have an IMAP server installed and
|
|
||||||
IMAP support compiled into PHP. You can have it installed as an Apache
|
|
||||||
module or command line version, the Apache module is preferred. We
|
|
||||||
will assume that you are running on a Linux or other Unix system for
|
|
||||||
these steps. Windows is supported, but there is no documentation for
|
|
||||||
it currently.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
In order to check if you have php installed create the file with your
|
|
||||||
favorite text editor named test.php in your webserver root directory:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
<TT><? phpinfo(); ?></TT>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Then point your browser to http://yourserverroot/test.php. You should
|
|
||||||
get a very detailed page describing various options in php.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
If you need to to compile php and apache the following links are good
|
|
||||||
starting points:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
A set of scripts to compile and install various modules with apache:
|
|
||||||
http://www.apachetoolbox.com
|
|
||||||
|
|
||||||
<P>
|
|
||||||
The Linux Apache MySQL PHP (LAMP) Guide v2 (latest as of this writing):
|
|
||||||
http://www.linuxhelp.net/guides/
|
|
||||||
|
|
||||||
<P>
|
|
||||||
The Soothing Seemless Setup of Apache, SSL, MySQL, and PHP: http://www.devshed.com/Server_Side/PHP/SoothinglySeamless
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00052000000000000000">
|
|
||||||
3.2 Tested Systems </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
On Linux 2.2.x, 2.4.x
|
|
||||||
|
|
||||||
<P>
|
|
||||||
PHP 3.0.15+ / PHP 4.0.x
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Apache 1.3.x
|
|
||||||
|
|
||||||
<P>
|
|
||||||
MySQL 3.22.25 or PostgreSQL 7.0.x
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Courier-IMAP 0.33+ and/or qmail 1.03 for POP3 access
|
|
||||||
|
|
||||||
<P>
|
|
||||||
We have reports of it working on Windows NT and OS/2, and using Oracle
|
|
||||||
as the database.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00060000000000000000">
|
|
||||||
4 Obtaining and Installing phpGroupWare </A>
|
|
||||||
</H1>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
After you have met the system requirements, You can install it from
|
|
||||||
the TarBall or you can get it directly from CVS.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00061000000000000000">
|
|
||||||
4.1 Installing from TarBall </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Installing from a TarBall is very easy. The files should be installed
|
|
||||||
in the webserver directory. Example steps (please adjust to your servers
|
|
||||||
config):
|
|
||||||
|
|
||||||
<P>
|
|
||||||
cp phpgroupware-version.tar.gz /home/httpd/html
|
|
||||||
|
|
||||||
<P>
|
|
||||||
cd /home/httpd/html
|
|
||||||
|
|
||||||
<P>
|
|
||||||
tar zxf phpgroupware-version.tar.gz
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You may have to get required permissions to do this. Contact your
|
|
||||||
system administrator if you dont have the permission to write to your
|
|
||||||
webserver directory.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You can get current releases of phpGroupWare at the phpGroupware <I>website</I>
|
|
||||||
(http://www.phpgroupware.org/downloads.php).
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00062000000000000000">
|
|
||||||
4.2 Installing from CVS </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Installing from a CVS is fairly easy. The files should be checked
|
|
||||||
out in the webserver directory. Example steps (please adjust to your
|
|
||||||
servers config):
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<UL>
|
|
||||||
<LI>cd /home/httpd/html
|
|
||||||
</LI>
|
|
||||||
<LI>cvs -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
login (just hit enter if prompted for a password)
|
|
||||||
</LI>
|
|
||||||
<LI>cvs -z3 -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
co phpgroupware
|
|
||||||
</LI>
|
|
||||||
</UL>
|
|
||||||
or if you prefer using CVSROOT:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<UL>
|
|
||||||
<LI>export CVSROOT=':pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware'
|
|
||||||
</LI>
|
|
||||||
<LI>cvs login (just hit enter if prompted for a password)
|
|
||||||
</LI>
|
|
||||||
<LI>cvs co phpgroupware
|
|
||||||
</LI>
|
|
||||||
</UL>
|
|
||||||
You may have to get required permissions to do this. Contact your
|
|
||||||
system administrator if you dont have the permission to write to your
|
|
||||||
webserver directory.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H3><A NAME="SECTION00062100000000000000">
|
|
||||||
4.2.1 Patched Branches in CVS</A>
|
|
||||||
</H3>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Recently the phpGroupWare developers started a branch for patches
|
|
||||||
to released versions. This is to facilitate bugs being fixed in a
|
|
||||||
released version without having to wait for the next offical release.
|
|
||||||
There is a developer who has been assigned the responsibility for
|
|
||||||
maintaining that branch and applying patches and fixes. To check out
|
|
||||||
this version of the code using 0.9.9 as an example you would do the
|
|
||||||
following:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<UL>
|
|
||||||
<LI>login to cvs anonymously as described above
|
|
||||||
</LI>
|
|
||||||
<LI>cvs -z3 -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
-r Version-0_9_9-patches phpgroupware
|
|
||||||
</LI>
|
|
||||||
</UL>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00063000000000000000">
|
|
||||||
4.3 Setting File Permissions </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
There are a few directories which will need special fie permissions
|
|
||||||
set for phpGroupWare to work properly.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Temp Directory (Required) - This can be /tmp for simplicity, but it
|
|
||||||
is required for several apps to function properly. Simply make sure
|
|
||||||
that the webserver can add/delete files in it.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Files Directory (Required) - This can be should be the files dir under
|
|
||||||
the phpgroupware dir. You will need to give the webserver account
|
|
||||||
owndership of this directory.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
chown nobody:nobody (note: this assumes your webserver runs as user
|
|
||||||
nobody, adjust for your installation)
|
|
||||||
|
|
||||||
<P>
|
|
||||||
chmod 700 /home/httpd/html/phpgroupware/files
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Root Directory (Not recommended) - If you give the webserver account
|
|
||||||
write access to the phpgroupware directory, then the setup program
|
|
||||||
can create the header.inc.php for you. Otherwise you will need to
|
|
||||||
use the setup program to create it, and then you can manually save
|
|
||||||
it to file.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
If you want to do it:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
chown :nobody /home/httpd/html/phpgroupware
|
|
||||||
|
|
||||||
<P>
|
|
||||||
chmod 770
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You may have to get required permissions to do this. Contact your
|
|
||||||
system administrator if you dont have the permission to write to your
|
|
||||||
webserver directory.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00064000000000000000">
|
|
||||||
4.4 Setup the database</A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You need to create empty databases for the setup app to create the
|
|
||||||
tables in.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H3><A NAME="SECTION00064100000000000000">
|
|
||||||
4.4.1 Mysql (assuming an existing and working Mysql install)</A>
|
|
||||||
</H3>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<UL>
|
|
||||||
<LI>Mandrake or Redhat: /etc/rc.d/init.d/mysqld start
|
|
||||||
</LI>
|
|
||||||
<LI>other: /usr/local/mysql/bin/safe_mysqld &
|
|
||||||
</LI>
|
|
||||||
<LI>create the empty database: mysqldadmin -u someuser create phpgroupware
|
|
||||||
-p
|
|
||||||
</LI>
|
|
||||||
<LI>login to mysql: mysql -u someuser -p
|
|
||||||
</LI>
|
|
||||||
<LI>issue the following at the mysql prompt:
|
|
||||||
</LI>
|
|
||||||
<LI>grant all on phpgroupware.* to phpgroupware@localhost identified
|
|
||||||
by ``somepassword'';
|
|
||||||
</LI>
|
|
||||||
</UL>
|
|
||||||
For more detailed user documentation on Mysql see their website :
|
|
||||||
http://www.mysql.com
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H3><A NAME="SECTION00064200000000000000">
|
|
||||||
4.4.2 Postgresql (assuming an existing and working Postgresql install)</A>
|
|
||||||
</H3>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
To create the required database in Postgresql make sure postgresql
|
|
||||||
is started:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<UL>
|
|
||||||
<LI>Mandrake or Redhat : /etc/rc.d/init.d/postgresql start
|
|
||||||
</LI>
|
|
||||||
<LI>others: /usr/bin/postmaster -D /var/lib/pgsql/data or /usr/bin/pg_ctl
|
|
||||||
-D /var/lib/pgsq/data start (adjust for your install dirs)
|
|
||||||
</LI>
|
|
||||||
<LI>create the empty database: /usr/bin/createdb phpgroupware
|
|
||||||
</LI>
|
|
||||||
<LI>create a database user: /usr/bin/createuser phpgroupware
|
|
||||||
</LI>
|
|
||||||
</UL>
|
|
||||||
For more detailed user documentation on Postgresql see their website
|
|
||||||
: http://www.postgresql.org
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00065000000000000000">
|
|
||||||
4.5 Setup / Configure phpGroupWare </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Point your browser to http://yourserverroot/phpgroupware/setup/ which
|
|
||||||
will create (or upgrade) the header.inc.php and database tables. Setup
|
|
||||||
will attempt to determine what version of the phpGroupWare databases
|
|
||||||
and header.inc.php you have installed, and upgrade to the most recent
|
|
||||||
version.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
<B>Note:</B> You are advised to backup your existing database before
|
|
||||||
running the setup script to avoid problems!
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00066000000000000000">
|
|
||||||
4.6 Testing the install </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
If your config is setup properly you can now login. Point your browser
|
|
||||||
to the installed location and login with the username demo and the
|
|
||||||
password is 1234
|
|
||||||
|
|
||||||
<P>
|
|
||||||
At this point it would be a good idea to create a new user with administrative
|
|
||||||
privileges and delete the old one.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00067000000000000000">
|
|
||||||
4.7 Installing additional applications </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Once you have the core phpGroupWare install up and running, you may
|
|
||||||
want to download and install additional applications.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You should consult any README or INSTALL files that come with the
|
|
||||||
new application first, as most require you to create additional tables
|
|
||||||
in the database, and add additional translation data to the lang table
|
|
||||||
(typically a file called lang.sql)
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You install the new application within the phpGroupWare install tree
|
|
||||||
by copying the application directory into the phpGroupWare install
|
|
||||||
location, and enabling the application through the Administration
|
|
||||||
page.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
For example, this is the process to install the Headlines application:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
(see http://www.sourceforge.net/projects/phpgwapps for more
|
|
||||||
applications)
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Download the .tar.gz file for the application, or check out the source
|
|
||||||
with cvs with
|
|
||||||
|
|
||||||
<P>
|
|
||||||
export CVSROOT=':pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgwapps'
|
|
||||||
|
|
||||||
<P>
|
|
||||||
cvs login (just hit enter if prompted for a password)
|
|
||||||
|
|
||||||
<P>
|
|
||||||
cvs co headlines
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Move the headlines directory into your phpGroupWare install directory.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Log into phpGroupWare as an administrative user, and go to the Administration
|
|
||||||
page.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
In the first section, choose the Applications link.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Click on add, and fill in the form.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Application name should be identical to the name of the directory
|
|
||||||
you moved into the phpGroupWare install, in this case use headlines
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Application Title is shown in the navigation bar and other places
|
|
||||||
to refer to the new application. Enter Headlines for this example.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Enabled can be used to disable an application for all users temporially.
|
|
||||||
You should normal check the box to enable the application.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Back in the Administration page, you need to enable the application
|
|
||||||
for specific users or user groups by editing them, and checking the
|
|
||||||
new Headlines box that appears in the middle of the account editing
|
|
||||||
page.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Once you have added the Headlines app to your account, you should
|
|
||||||
see a Headlines entry in the Administration and Preferences pages,
|
|
||||||
and there should be an icon for the Headlines application in the navigation
|
|
||||||
bar.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Once you enable a few of the Headlines sites through the Administration
|
|
||||||
page link, you should see headlines grabbed from the sites you selected
|
|
||||||
when you click on the Headlines icon in the navigation bar.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00070000000000000000">
|
|
||||||
5 Trouble Shooting</A>
|
|
||||||
</H1>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
<B>Warning </B>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
phpGroupWare is still Beta software, expect some bugs along the way.
|
|
||||||
If you run into a problem not discussed here, contact us through one
|
|
||||||
of the methods listed on the website.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
The phpGroupWare developers can most often be seen hanging out in
|
|
||||||
<I>#phpGroupWare</I> on <I>irc.openprojects.net</I> if you require
|
|
||||||
real-time help.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Also check the FAQ in this directory for additional common questions,
|
|
||||||
it is available as FAQ.sgml, FAQ.txt and FAQ.html
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00071000000000000000">
|
|
||||||
5.1 It seems to hang when I try to read my mail </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
This is often a problem if you are using POP3 instead of IMAP, and
|
|
||||||
you have more than a few hundred messages in your mailbox.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
By default, php is set up to time-out a request that takes over 30
|
|
||||||
seconds to complete. phpGroupWare must do a lot of work the first
|
|
||||||
time your POP3 mailbox is opened, and every time you get new mail,
|
|
||||||
which may take more than the 30 second timeout.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You can either clean up your mailbox with another mail program, or
|
|
||||||
add the line
|
|
||||||
|
|
||||||
<P>
|
|
||||||
set_time_limit(0);
|
|
||||||
|
|
||||||
<P>
|
|
||||||
to the top of the phpgwapi/inc/phpgw_msg_pop3.inc.php file, just
|
|
||||||
before the line class msg extends msg_common
|
|
||||||
|
|
||||||
<P>
|
|
||||||
If you choose to edit the file, be patient when loading a large POP3
|
|
||||||
mailbox - the author tested against a mailbox with 2500 messages in
|
|
||||||
it, but it took 15 minutes to load the page. We highly suggest you
|
|
||||||
use IMAP if you expect to have more than a few hundred messages in
|
|
||||||
your mailbox.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00072000000000000000">
|
|
||||||
5.2 When I log in I see the directory listing instead of a web page </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
You are using Apache, this often means you need to add .php to the
|
|
||||||
DirectoryIndex line in your httpd.conf file. For example:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
DirectoryIndex index.php index.php3 index.html index.htm index.cgi
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00073000000000000000">
|
|
||||||
5.3 I get garbage that looks like code when I go to the phpGroupWare
|
|
||||||
URL </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
This is often because you have php3 installed, which does not map
|
|
||||||
.php to the PHP engine. For PHP3:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
AddType application/x-httpd-php3 .php3 .php
|
|
||||||
|
|
||||||
<P>
|
|
||||||
For PHP4:
|
|
||||||
|
|
||||||
<P>
|
|
||||||
AddType application/x-httpd-php .php3 .php
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00080000000000000000">
|
|
||||||
6 About this document</A>
|
|
||||||
</H1>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
The newest version of this document can be found on our website http://www.phpgroupware.org
|
|
||||||
as lyx source, HTML, or TEXT.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Comments on this HOWTO should be directed to the phpGroupWare developers
|
|
||||||
mailing list <I>phpgroupware-developers@lists.sourceforge.net</I>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
To subscribe, go to <I>http://sourceforge.net/mail/?group_id=7305</I>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00081000000000000000">
|
|
||||||
6.1 History </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
This document was started by Joseph Engo reworked by Dan Kuykendall
|
|
||||||
then edited by Darryl VanDorp
|
|
||||||
|
|
||||||
<P>
|
|
||||||
|
|
||||||
<H2><A NAME="SECTION00082000000000000000">
|
|
||||||
6.2 Version History </A>
|
|
||||||
</H2>
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Old Version
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Created by Jengo, wasn't in SGML HOWTO format.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
v1.0 (July 6, 2000)
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Built proper SGML version.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Included the FAQ.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Other minor additions.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
v1.1 (September 27-29, 2000) - blinky
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Added Testing Install section
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Added Trouble-shooting section
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Added description of application installation
|
|
||||||
|
|
||||||
<P>
|
|
||||||
Changes for the new setup program
|
|
||||||
|
|
||||||
<P>
|
|
||||||
v0.01 (October 15 , 2000) - gnrfan , Converted the HOWTO to DocBook
|
|
||||||
format
|
|
||||||
|
|
||||||
<P>
|
|
||||||
v.0.05 (November 5, 2000) - gnrfan , Completely revamped according
|
|
||||||
to Seek's idea and intregrated the Developers HOWTO.
|
|
||||||
|
|
||||||
<P>
|
|
||||||
v.0.06 (Jan 10, 2001) - Darryl VanDorp, imported to lyx source reformatted
|
|
||||||
and touched up some sections
|
|
||||||
|
|
||||||
<P>
|
|
||||||
v.0.07 (Jan 16, 2001) - Darryl VanDorp, added TOC, fixed some Postgresql
|
|
||||||
setup instructions, added some links to install/compilation instructions
|
|
||||||
for apache, php and mysql.`
|
|
||||||
|
|
||||||
<P>
|
|
||||||
v.0.08 (Feb 22, 2001) - Darryl VanDorp, added a multipart html export
|
|
||||||
|
|
||||||
<H1><A NAME="SECTION00090000000000000000">
|
|
||||||
About this document ...</A>
|
|
||||||
</H1>
|
|
||||||
<STRONG><B>phpGroupWare Installation</B></STRONG><P>
|
|
||||||
This document was generated using the
|
|
||||||
<A HREF="http://www-dsed.llnl.gov/files/programs/unix/latex2html/manual/"><STRONG>LaTeX</STRONG>2<tt>HTML</tt></A> translator Version 99.2beta8 (1.42)
|
|
||||||
<P>
|
|
||||||
Copyright © 1993, 1994, 1995, 1996,
|
|
||||||
<A HREF="http://cbl.leeds.ac.uk/nikos/personal.html">Nikos Drakos</A>,
|
|
||||||
Computer Based Learning Unit, University of Leeds.
|
|
||||||
<BR>
|
|
||||||
Copyright © 1997, 1998, 1999,
|
|
||||||
<A HREF="http://www.maths.mq.edu.au/~ross/">Ross Moore</A>,
|
|
||||||
Mathematics Department, Macquarie University, Sydney.
|
|
||||||
<P>
|
|
||||||
The command line arguments were: <BR>
|
|
||||||
<STRONG>latex2html</STRONG> <TT>-no_subdir -split 0 -show_section_numbers /tmp/lyx_tmpdir1982sfZANo/lyx_tmpbuf198227Nfzx/index.tex</TT>
|
|
||||||
<P>
|
|
||||||
The translation was initiated by Darryl on 2001-02-22<HR>
|
|
||||||
<!--Navigation Panel-->
|
|
||||||
<IMG WIDTH="81" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next_inactive"
|
|
||||||
SRC="file:/usr/lib/latex2html/icons/nx_grp_g.png">
|
|
||||||
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up"
|
|
||||||
SRC="file:/usr/lib/latex2html/icons/up_g.png">
|
|
||||||
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous"
|
|
||||||
SRC="file:/usr/lib/latex2html/icons/prev_g.png">
|
|
||||||
<BR>
|
|
||||||
<!--End of Navigation Panel-->
|
|
||||||
<ADDRESS>
|
|
||||||
Darryl
|
|
||||||
2001-02-22
|
|
||||||
</ADDRESS>
|
|
||||||
</BODY>
|
|
||||||
</HTML>
|
|
||||||
706
doc/index.lyx
706
doc/index.lyx
@ -1,706 +0,0 @@
|
|||||||
#LyX 1.1 created this file. For more info see http://www.lyx.org/
|
|
||||||
\lyxformat 218
|
|
||||||
\textclass article
|
|
||||||
\begin_preamble
|
|
||||||
\usepackage{fullpage, graphicx, url}
|
|
||||||
\setlength{\parskip}{1ex}
|
|
||||||
\setlength{\parindent}{0ex}
|
|
||||||
\title{phpGroupWare Docs}
|
|
||||||
\end_preamble
|
|
||||||
\language english
|
|
||||||
\inputencoding auto
|
|
||||||
\fontscheme default
|
|
||||||
\graphics default
|
|
||||||
\paperfontsize 10
|
|
||||||
\spacing single
|
|
||||||
\papersize Default
|
|
||||||
\paperpackage a4
|
|
||||||
\use_geometry 0
|
|
||||||
\use_amsmath 0
|
|
||||||
\paperorientation portrait
|
|
||||||
\secnumdepth 3
|
|
||||||
\tocdepth 3
|
|
||||||
\paragraph_separation indent
|
|
||||||
\defskip medskip
|
|
||||||
\quotes_language english
|
|
||||||
\quotes_times 2
|
|
||||||
\papercolumns 1
|
|
||||||
\papersides 1
|
|
||||||
\paperpagestyle default
|
|
||||||
|
|
||||||
\layout Title
|
|
||||||
|
|
||||||
|
|
||||||
\series bold
|
|
||||||
phpGroupWare Installation
|
|
||||||
\layout Author
|
|
||||||
|
|
||||||
|
|
||||||
\series bold
|
|
||||||
Joseph Engo
|
|
||||||
\layout Author
|
|
||||||
|
|
||||||
|
|
||||||
\series bold
|
|
||||||
Dan Kuykendall
|
|
||||||
\series default
|
|
||||||
|
|
||||||
\layout Author
|
|
||||||
|
|
||||||
Editor: Darryl VanDorp
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
$Id$
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
|
|
||||||
\begin_inset LatexCommand \tableofcontents{}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
|
|
||||||
\layout Section*
|
|
||||||
|
|
||||||
Dedication
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
||||||
\layout Section
|
|
||||||
|
|
||||||
What is phpGroupWare
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
phpGroupWare is a web based GroupWare system.
|
|
||||||
It comes with serveral core apps for email, calendar, todo list, address
|
|
||||||
book, file manager, and a notepad.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
It also provides a framework for add-on applications to integrate seamlessly
|
|
||||||
in phpGroupWare.
|
|
||||||
Some samples are a bookmark manager, a trouble ticket system, a weather
|
|
||||||
reporter, a phone log, a chat program, and a forum system.
|
|
||||||
There are many more in development, and you can develop your own as well.
|
|
||||||
|
|
||||||
\layout Section
|
|
||||||
|
|
||||||
Why you should use it
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You should use it if you would like a powerful groupware system that can
|
|
||||||
be access from anywhere on the Internet, and allows for custom add-ons.
|
|
||||||
For companies with a distributed user base, it's an ideal solution.
|
|
||||||
Oh, and did I mention that its FREE?
|
|
||||||
\layout Section
|
|
||||||
|
|
||||||
Installation
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Installation and Configuration of phpGroupWare has never been easier.
|
|
||||||
Just point and click, yeah it's very easy.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Since this is still a beta version we do expect some bugs.
|
|
||||||
By carefully reading this document you can easly install phpGroupWare.
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Requirements
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You will need PHP compiled and installed on your system.
|
|
||||||
You will also need MySQL or PostgreSQL setup.
|
|
||||||
If you are planning on using the email system, you will need to have an
|
|
||||||
IMAP server installed and IMAP support compiled into PHP.
|
|
||||||
You can have it installed as an Apache module or command line version,
|
|
||||||
the Apache module is preferred.
|
|
||||||
We will assume that you are running on a Linux or other Unix system for
|
|
||||||
these steps.
|
|
||||||
Windows is supported, but there is no documentation for it currently.
|
|
||||||
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
In order to check if you have php installed create the file with your favorite
|
|
||||||
text editor named test.php in your webserver root directory:
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
|
|
||||||
\family typewriter
|
|
||||||
<? phpinfo(); ?>
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Then point your browser to http://yourserverroot/test.php.
|
|
||||||
You should get a very detailed page describing various options in php.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
If you need to to compile php and apache the following links are good starting
|
|
||||||
points:
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
A set of scripts to compile and install various modules with apache:
|
|
||||||
\begin_inset LatexCommand \url{http://www.apachetoolbox.com}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
The Linux Apache MySQL PHP (LAMP) Guide v2 (latest as of this writing):
|
|
||||||
|
|
||||||
\begin_inset LatexCommand \url{http://www.linuxhelp.net/guides/}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
The Soothing Seemless Setup of Apache, SSL, MySQL, and PHP:
|
|
||||||
\begin_inset LatexCommand \url{http://www.devshed.com/Server_Side/PHP/SoothinglySeamless}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Tested Systems
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
On Linux 2.2.x, 2.4.x
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
PHP 3.0.15+ / PHP 4.0.x
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Apache 1.3.x
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
MySQL 3.22.25 or PostgreSQL 7.0.x
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Courier-IMAP 0.33+ and/or qmail 1.03 for POP3 access
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
We have reports of it working on Windows NT and OS/2, and using Oracle as
|
|
||||||
the database.
|
|
||||||
|
|
||||||
\layout Section
|
|
||||||
|
|
||||||
Obtaining and Installing phpGroupWare
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
After you have met the system requirements, You can install it from the
|
|
||||||
TarBall or you can get it directly from CVS.
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Installing from TarBall
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Installing from a TarBall is very easy.
|
|
||||||
The files should be installed in the webserver directory.
|
|
||||||
Example steps (please adjust to your servers config):
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
cp phpgroupware-version.tar.gz /home/httpd/html
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
cd /home/httpd/html
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
tar zxf phpgroupware-version.tar.gz
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You may have to get required permissions to do this.
|
|
||||||
Contact your system administrator if you dont have the permission to write
|
|
||||||
to your webserver directory.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You can get current releases of phpGroupWare at the phpGroupware
|
|
||||||
\emph on
|
|
||||||
website
|
|
||||||
\emph default
|
|
||||||
(
|
|
||||||
\latex latex
|
|
||||||
|
|
||||||
\backslash
|
|
||||||
url{http://www.phpgroupware.org/downloads.php}
|
|
||||||
\latex default
|
|
||||||
).
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Installing from CVS
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Installing from a CVS is fairly easy.
|
|
||||||
The files should be checked out in the webserver directory.
|
|
||||||
Example steps (please adjust to your servers config):
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
cd /home/httpd/html
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
cvs -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
login (just hit enter if prompted for a password)
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
cvs -z3 -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
co phpgroupware
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
or if you prefer using CVSROOT:
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
export CVSROOT=':pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgro
|
|
||||||
upware'
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
cvs login (just hit enter if prompted for a password)
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
cvs co phpgroupware
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You may have to get required permissions to do this.
|
|
||||||
Contact your system administrator if you dont have the permission to write
|
|
||||||
to your webserver directory.
|
|
||||||
|
|
||||||
\layout Subsubsection
|
|
||||||
|
|
||||||
Patched Branches in CVS
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Recently the phpGroupWare developers started a branch for patches to released
|
|
||||||
versions.
|
|
||||||
This is to facilitate bugs being fixed in a released version without having
|
|
||||||
to wait for the next offical release.
|
|
||||||
There is a developer who has been assigned the responsibility for maintaining
|
|
||||||
that branch and applying patches and fixes.
|
|
||||||
To check out this version of the code using 0.9.9 as an example you would
|
|
||||||
do the following:
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
login to cvs anonymously as described above
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
cvs -z3 -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
-r Version-0_9_9-patches co phpgroupware
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Setting File Permissions
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
There are a few directories which will need special fie permissions set
|
|
||||||
for phpGroupWare to work properly.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Temp Directory (Required) - This can be /tmp for simplicity, but it is required
|
|
||||||
for several apps to function properly.
|
|
||||||
Simply make sure that the webserver can add/delete files in it.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Files Directory (Required) - This can be should be the files dir under the
|
|
||||||
phpgroupware dir.
|
|
||||||
You will need to give the webserver account owndership of this directory.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
chown nobody:nobody (note: this assumes your webserver runs as user nobody,
|
|
||||||
adjust for your installation)
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
chmod 700 /home/httpd/html/phpgroupware/files
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Root Directory (Not recommended) - If you give the webserver account write
|
|
||||||
access to the phpgroupware directory, then the setup program can create
|
|
||||||
the header.inc.php for you.
|
|
||||||
Otherwise you will need to use the setup program to create it, and then
|
|
||||||
you can manually save it to file.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
If you want to do it:
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
chown :nobody /home/httpd/html/phpgroupware
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
chmod 770
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You may have to get required permissions to do this.
|
|
||||||
Contact your system administrator if you dont have the permission to write
|
|
||||||
to your webserver directory.
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Setup the database
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You need to create empty databases for the setup app to create the tables
|
|
||||||
in.
|
|
||||||
\layout Subsubsection
|
|
||||||
|
|
||||||
Mysql (assuming an existing and working Mysql install)
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
Mandrake or Redhat: /etc/rc.d/init.d/mysqld start
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
other: /usr/local/mysql/bin/safe_mysqld &
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
create the empty database: mysqldadmin -u someuser create phpgroupware -p
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
login to mysql: mysql -u someuser -p
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
issue the following at the mysql prompt:
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
grant all on phpgroupware.* to phpgroupware@localhost identified by
|
|
||||||
\begin_inset Quotes eld
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
somepassword
|
|
||||||
\begin_inset Quotes erd
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
;
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
For more detailed user documentation on Mysql see their website :
|
|
||||||
\begin_inset LatexCommand \url{http://www.mysql.com}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
|
|
||||||
\layout Subsubsection
|
|
||||||
|
|
||||||
Postgresql (assuming an existing and working Postgresql install)
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
To create the required database in Postgresql make sure postgresql is started:
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
Mandrake or Redhat : /etc/rc.d/init.d/postgresql start
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
others: /usr/bin/postmaster -D /var/lib/pgsql/data or /usr/bin/pg_ctl -D
|
|
||||||
/var/lib/pgsq/data start (adjust for your install dirs)
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
create the empty database: /usr/bin/createdb phpgroupware
|
|
||||||
\layout Itemize
|
|
||||||
|
|
||||||
create a database user: /usr/bin/createuser phpgroupware
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
For more detailed user documentation on Postgresql see their website :
|
|
||||||
\begin_inset LatexCommand \url{http://www.postgresql.org}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Setup / Configure phpGroupWare
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Point your browser to http://yourserverroot/phpgroupware/setup/ which will
|
|
||||||
create (or upgrade) the header.inc.php and database tables.
|
|
||||||
Setup will attempt to determine what version of the phpGroupWare databases
|
|
||||||
and header.inc.php you have installed, and upgrade to the most recent version.
|
|
||||||
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
|
|
||||||
\series bold
|
|
||||||
Note:
|
|
||||||
\series default
|
|
||||||
You are advised to backup your existing database before running the setup
|
|
||||||
script to avoid problems!
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Testing the install
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
If your config is setup properly you can now login.
|
|
||||||
Point your browser to the installed location and login with the username
|
|
||||||
demo and the password is 1234
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
At this point it would be a good idea to create a new user with administrative
|
|
||||||
privileges and delete the old one.
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Installing additional applications
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Once you have the core phpGroupWare install up and running, you may want
|
|
||||||
to download and install additional applications.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You should consult any README or INSTALL files that come with the new applicatio
|
|
||||||
n first, as most require you to create additional tables in the database,
|
|
||||||
and add additional translation data to the lang table (typically a file
|
|
||||||
called lang.sql)
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You install the new application within the phpGroupWare install tree by
|
|
||||||
copying the application directory into the phpGroupWare install location,
|
|
||||||
and enabling the application through the Administration page.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
For example, this is the process to install the Headlines application:
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
(see
|
|
||||||
\begin_inset LatexCommand \url{http://www.sourceforge.net/projects/phpgwapps}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
for more applications)
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Download the .tar.gz file for the application, or check out the source with
|
|
||||||
cvs with
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
export CVSROOT=':pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgwa
|
|
||||||
pps'
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
cvs login (just hit enter if prompted for a password)
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
cvs co headlines
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Move the headlines directory into your phpGroupWare install directory.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Log into phpGroupWare as an administrative user, and go to the Administration
|
|
||||||
page.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
In the first section, choose the Applications link.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Click on add, and fill in the form.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Application name should be identical to the name of the directory you moved
|
|
||||||
into the phpGroupWare install, in this case use headlines
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Application Title is shown in the navigation bar and other places to refer
|
|
||||||
to the new application.
|
|
||||||
Enter Headlines for this example.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Enabled can be used to disable an application for all users temporially.
|
|
||||||
You should normal check the box to enable the application.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Back in the Administration page, you need to enable the application for
|
|
||||||
specific users or user groups by editing them, and checking the new Headlines
|
|
||||||
box that appears in the middle of the account editing page.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Once you have added the Headlines app to your account, you should see a
|
|
||||||
Headlines entry in the Administration and Preferences pages, and there
|
|
||||||
should be an icon for the Headlines application in the navigation bar.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Once you enable a few of the Headlines sites through the Administration
|
|
||||||
page link, you should see headlines grabbed from the sites you selected
|
|
||||||
when you click on the Headlines icon in the navigation bar.
|
|
||||||
|
|
||||||
\layout Section
|
|
||||||
|
|
||||||
Trouble Shooting
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
|
|
||||||
\series bold
|
|
||||||
Warning
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
phpGroupWare is still Beta software, expect some bugs along the way.
|
|
||||||
If you run into a problem not discussed here, contact us through one of
|
|
||||||
the methods listed on the website.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
The phpGroupWare developers can most often be seen hanging out in
|
|
||||||
\emph on
|
|
||||||
#phpGroupWare
|
|
||||||
\emph default
|
|
||||||
on
|
|
||||||
\emph on
|
|
||||||
irc.openprojects.net
|
|
||||||
\emph default
|
|
||||||
if you require real-time help.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Also check the FAQ in this directory for additional common questions, it
|
|
||||||
is available as FAQ.sgml, FAQ.txt and FAQ.html
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
It seems to hang when I try to read my mail
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
This is often a problem if you are using POP3 instead of IMAP, and you have
|
|
||||||
more than a few hundred messages in your mailbox.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
By default, php is set up to time-out a request that takes over 30 seconds
|
|
||||||
to complete.
|
|
||||||
phpGroupWare must do a lot of work the first time your POP3 mailbox is
|
|
||||||
opened, and every time you get new mail, which may take more than the 30
|
|
||||||
second timeout.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You can either clean up your mailbox with another mail program, or add the
|
|
||||||
line
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
set_time_limit(0);
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
to the top of the phpgwapi/inc/phpgw_msg_pop3.inc.php file, just before the
|
|
||||||
line class msg extends msg_common
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
If you choose to edit the file, be patient when loading a large POP3 mailbox
|
|
||||||
- the author tested against a mailbox with 2500 messages in it, but it
|
|
||||||
took 15 minutes to load the page.
|
|
||||||
We highly suggest you use IMAP if you expect to have more than a few hundred
|
|
||||||
messages in your mailbox.
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
When I log in I see the directory listing instead of a web page
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
You are using Apache, this often means you need to add .php to the DirectoryIndex
|
|
||||||
line in your httpd.conf file.
|
|
||||||
For example:
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
DirectoryIndex index.php index.php3 index.html index.htm index.cgi
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
I get garbage that looks like code when I go to the phpGroupWare URL
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
This is often because you have php3 installed, which does not map .php to
|
|
||||||
the PHP engine.
|
|
||||||
For PHP3:
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
AddType application/x-httpd-php3 .php3 .php
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
For PHP4:
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
AddType application/x-httpd-php .php3 .php
|
|
||||||
\layout Section
|
|
||||||
|
|
||||||
About this document
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
The newest version of this document can be found on our website
|
|
||||||
\begin_inset LatexCommand \url{http://www.phpgroupware.org}
|
|
||||||
|
|
||||||
\end_inset
|
|
||||||
|
|
||||||
as lyx source, HTML, or TEXT.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Comments on this HOWTO should be directed to the phpGroupWare developers
|
|
||||||
mailing list
|
|
||||||
\emph on
|
|
||||||
phpgroupware-developers@lists.sourceforge.net
|
|
||||||
\emph default
|
|
||||||
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
To subscribe, go to
|
|
||||||
\emph on
|
|
||||||
\latex latex
|
|
||||||
|
|
||||||
\backslash
|
|
||||||
url{http://sourceforge.net/mail/?group}
|
|
||||||
\latex default
|
|
||||||
_id=7305
|
|
||||||
\emph default
|
|
||||||
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
History
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
This document was started by Joseph Engo reworked by Dan Kuykendall then
|
|
||||||
edited by Darryl VanDorp
|
|
||||||
\layout Subsection
|
|
||||||
|
|
||||||
Version History
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Old Version
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Created by Jengo, wasn't in SGML HOWTO format.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
v1.0 (July 6, 2000)
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Built proper SGML version.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Included the FAQ.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Other minor additions.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
v1.1 (September 27-29, 2000) - blinky
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Added Testing Install section
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Added Trouble-shooting section
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Added description of application installation
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
Changes for the new setup program
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
v0.01 (October 15 , 2000) - gnrfan , Converted the HOWTO to DocBook format
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
v.0.05 (November 5, 2000) - gnrfan , Completely revamped according to Seek's
|
|
||||||
idea and intregrated the Developers HOWTO.
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
v.0.06 (Jan 10, 2001) - Darryl VanDorp, imported to lyx source reformatted
|
|
||||||
and touched up some sections
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
v.0.07 (Jan 16, 2001) - Darryl VanDorp, added TOC, fixed some Postgresql setup
|
|
||||||
instructions, added some links to install/compilation instructions for
|
|
||||||
apache, php and mysql.`
|
|
||||||
\layout Standard
|
|
||||||
|
|
||||||
v.0.08 (Feb 22, 2001) - Darryl VanDorp, added a multipart html export
|
|
||||||
\the_end
|
|
||||||
BIN
doc/index.pdf
BIN
doc/index.pdf
Binary file not shown.
1629
doc/index.ps
1629
doc/index.ps
File diff suppressed because it is too large
Load Diff
472
doc/index.txt
472
doc/index.txt
@ -1,472 +0,0 @@
|
|||||||
|
|
||||||
|
|
||||||
phpGroupWare Installation
|
|
||||||
|
|
||||||
Joseph Engo
|
|
||||||
|
|
||||||
Dan Kuykendall
|
|
||||||
|
|
||||||
Editor: Darryl VanDorp
|
|
||||||
|
|
||||||
$Id$
|
|
||||||
|
|
||||||
Table of Contents
|
|
||||||
|
|
||||||
1 What is phpGroupWare
|
|
||||||
2 Why you should use it
|
|
||||||
3 Installation
|
|
||||||
3.1 Requirements
|
|
||||||
3.2 Tested Systems
|
|
||||||
4 Obtaining and Installing phpGroupWare
|
|
||||||
4.1 Installing from TarBall
|
|
||||||
4.2 Installing from CVS
|
|
||||||
4.2.1 Patched Branches in CVS
|
|
||||||
4.3 Setting File Permissions
|
|
||||||
4.4 Setup the database
|
|
||||||
4.4.1 Mysql (assuming an existing and working Mysql install)
|
|
||||||
4.4.2 Postgresql (assuming an existing and working Postgresql install)
|
|
||||||
4.5 Setup / Configure phpGroupWare
|
|
||||||
4.6 Testing the install
|
|
||||||
4.7 Installing additional applications
|
|
||||||
5 Trouble Shooting
|
|
||||||
5.1 It seems to hang when I try to read my mail
|
|
||||||
5.2 When I log in I see the directory listing instead of a web page
|
|
||||||
5.3 I get garbage that looks like code when I go to the phpGroupWare URL
|
|
||||||
6 About this document
|
|
||||||
6.1 History
|
|
||||||
6.2 Version History
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Dedication
|
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
||||||
1 What is phpGroupWare
|
|
||||||
|
|
||||||
phpGroupWare is a web based GroupWare system. It comes with
|
|
||||||
serveral core apps for email, calendar, todo list, address
|
|
||||||
book, file manager, and a notepad.
|
|
||||||
|
|
||||||
It also provides a framework for add-on applications to integrate
|
|
||||||
seamlessly in phpGroupWare. Some samples are a bookmark
|
|
||||||
manager, a trouble ticket system, a weather reporter, a
|
|
||||||
phone log, a chat program, and a forum system. There are
|
|
||||||
many more in development, and you can develop your own as
|
|
||||||
well.
|
|
||||||
|
|
||||||
2 Why you should use it
|
|
||||||
|
|
||||||
You should use it if you would like a powerful groupware
|
|
||||||
system that can be access from anywhere on the Internet,
|
|
||||||
and allows for custom add-ons. For companies with a distributed
|
|
||||||
user base, it's an ideal solution. Oh, and did I mention
|
|
||||||
that its FREE?
|
|
||||||
|
|
||||||
3 Installation
|
|
||||||
|
|
||||||
Installation and Configuration of phpGroupWare has never
|
|
||||||
been easier. Just point and click, yeah it's very easy.
|
|
||||||
|
|
||||||
Since this is still a beta version we do expect some bugs.
|
|
||||||
By carefully reading this document you can easly install
|
|
||||||
phpGroupWare.
|
|
||||||
|
|
||||||
3.1 Requirements
|
|
||||||
|
|
||||||
You will need PHP compiled and installed on your system.
|
|
||||||
You will also need MySQL or PostgreSQL setup. If you are
|
|
||||||
planning on using the email system, you will need to have
|
|
||||||
an IMAP server installed and IMAP support compiled into
|
|
||||||
PHP. You can have it installed as an Apache module or command
|
|
||||||
line version, the Apache module is preferred. We will assume
|
|
||||||
that you are running on a Linux or other Unix system for
|
|
||||||
these steps. Windows is supported, but there is no documentation
|
|
||||||
for it currently.
|
|
||||||
|
|
||||||
In order to check if you have php installed create the file
|
|
||||||
with your favorite text editor named test.php in your webserver
|
|
||||||
root directory:
|
|
||||||
|
|
||||||
<? phpinfo(); ?>
|
|
||||||
|
|
||||||
Then point your browser to http://yourserverroot/test.php.
|
|
||||||
You should get a very detailed page describing various options
|
|
||||||
in php.
|
|
||||||
|
|
||||||
If you need to to compile php and apache the following links
|
|
||||||
are good starting points:
|
|
||||||
|
|
||||||
A set of scripts to compile and install various modules with
|
|
||||||
apache: [http://www.apachetoolbox.com]
|
|
||||||
|
|
||||||
The Linux Apache MySQL PHP (LAMP) Guide v2 (latest as of
|
|
||||||
this writing): [http://www.linuxhelp.net/guides/]
|
|
||||||
|
|
||||||
The Soothing Seemless Setup of Apache, SSL, MySQL, and PHP: [http://www.devshed.com/Server_Side/PHP/SoothinglySeamless]
|
|
||||||
|
|
||||||
3.2 Tested Systems
|
|
||||||
|
|
||||||
On Linux 2.2.x, 2.4.x
|
|
||||||
|
|
||||||
PHP 3.0.15+ / PHP 4.0.x
|
|
||||||
|
|
||||||
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
|
|
||||||
|
|
||||||
We have reports of it working on Windows NT and OS/2, and
|
|
||||||
using Oracle as the database.
|
|
||||||
|
|
||||||
4 Obtaining and Installing phpGroupWare
|
|
||||||
|
|
||||||
After you have met the system requirements, You can install
|
|
||||||
it from the TarBall or you can get it directly from CVS.
|
|
||||||
|
|
||||||
4.1 Installing from TarBall
|
|
||||||
|
|
||||||
Installing from a TarBall is very easy. The files should
|
|
||||||
be installed in the webserver directory. Example steps (please
|
|
||||||
adjust to your servers config):
|
|
||||||
|
|
||||||
cp phpgroupware-version.tar.gz /home/httpd/html
|
|
||||||
|
|
||||||
cd /home/httpd/html
|
|
||||||
|
|
||||||
tar zxf phpgroupware-version.tar.gz
|
|
||||||
|
|
||||||
You may have to get required permissions to do this. Contact
|
|
||||||
your system administrator if you dont have the permission
|
|
||||||
to write to your webserver directory.
|
|
||||||
|
|
||||||
You can get current releases of phpGroupWare at the phpGroupware
|
|
||||||
website ().
|
|
||||||
|
|
||||||
4.2 Installing from CVS
|
|
||||||
|
|
||||||
Installing from a CVS is fairly easy. The files should be
|
|
||||||
checked out in the webserver directory. Example steps (please
|
|
||||||
adjust to your servers config):
|
|
||||||
|
|
||||||
* cd /home/httpd/html
|
|
||||||
|
|
||||||
* cvs -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
login (just hit enter if prompted for a password)
|
|
||||||
|
|
||||||
* cvs -z3 -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
co phpgroupware
|
|
||||||
|
|
||||||
or if you prefer using CVSROOT:
|
|
||||||
|
|
||||||
* export CVSROOT=':pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware'
|
|
||||||
|
|
||||||
* cvs login (just hit enter if prompted for a password)
|
|
||||||
|
|
||||||
* cvs co phpgroupware
|
|
||||||
|
|
||||||
You may have to get required permissions to do this. Contact
|
|
||||||
your system administrator if you dont have the permission
|
|
||||||
to write to your webserver directory.
|
|
||||||
|
|
||||||
4.2.1 Patched Branches in CVS
|
|
||||||
|
|
||||||
Recently the phpGroupWare developers started a branch for
|
|
||||||
patches to released versions. This is to facilitate bugs
|
|
||||||
being fixed in a released version without having to wait
|
|
||||||
for the next offical release. There is a developer who has
|
|
||||||
been assigned the responsibility for maintaining that branch
|
|
||||||
and applying patches and fixes. To check out this version
|
|
||||||
of the code using 0.9.9 as an example you would do the following:
|
|
||||||
|
|
||||||
* login to cvs anonymously as described above
|
|
||||||
|
|
||||||
* cvs -z3 -d:pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgroupware
|
|
||||||
-r Version-0_9_9-patches phpgroupware
|
|
||||||
|
|
||||||
4.3 Setting File Permissions
|
|
||||||
|
|
||||||
There are a few directories which will need special fie permissions
|
|
||||||
set for phpGroupWare to work properly.
|
|
||||||
|
|
||||||
Temp Directory (Required) - This can be /tmp for simplicity,
|
|
||||||
but it is required for several apps to function properly.
|
|
||||||
Simply make sure that the webserver can add/delete files
|
|
||||||
in it.
|
|
||||||
|
|
||||||
Files Directory (Required) - This can be should be the files
|
|
||||||
dir under the phpgroupware dir. You will need to give the
|
|
||||||
webserver account owndership of this directory.
|
|
||||||
|
|
||||||
chown nobody:nobody (note: this assumes your webserver runs
|
|
||||||
as user nobody, adjust for your installation)
|
|
||||||
|
|
||||||
chmod 700 /home/httpd/html/phpgroupware/files
|
|
||||||
|
|
||||||
Root Directory (Not recommended) - If you give the webserver
|
|
||||||
account write access to the phpgroupware directory, then
|
|
||||||
the setup program can create the header.inc.php for you.
|
|
||||||
Otherwise you will need to use the setup program to create
|
|
||||||
it, and then you can manually save it to file.
|
|
||||||
|
|
||||||
If you want to do it:
|
|
||||||
|
|
||||||
chown :nobody /home/httpd/html/phpgroupware
|
|
||||||
|
|
||||||
chmod 770
|
|
||||||
|
|
||||||
You may have to get required permissions to do this. Contact
|
|
||||||
your system administrator if you dont have the permission
|
|
||||||
to write to your webserver directory.
|
|
||||||
|
|
||||||
4.4 Setup the database
|
|
||||||
|
|
||||||
You need to create empty databases for the setup app to create
|
|
||||||
the tables in.
|
|
||||||
|
|
||||||
4.4.1 Mysql (assuming an existing and working Mysql install)
|
|
||||||
|
|
||||||
* Mandrake or Redhat: /etc/rc.d/init.d/mysqld start
|
|
||||||
|
|
||||||
* other: /usr/local/mysql/bin/safe_mysqld &
|
|
||||||
|
|
||||||
* create the empty database: mysqldadmin -u someuser create
|
|
||||||
phpgroupware -p
|
|
||||||
|
|
||||||
* login to mysql: mysql -u someuser -p
|
|
||||||
|
|
||||||
* issue the following at the mysql prompt:
|
|
||||||
|
|
||||||
* grant all on phpgroupware.* to phpgroupware@localhost identified
|
|
||||||
by "somepassword";
|
|
||||||
|
|
||||||
For more detailed user documentation on Mysql see their website
|
|
||||||
: [http://www.mysql.com]
|
|
||||||
|
|
||||||
4.4.2 Postgresql (assuming an existing and working Postgresql
|
|
||||||
install)
|
|
||||||
|
|
||||||
To create the required database in Postgresql make sure postgresql
|
|
||||||
is started:
|
|
||||||
|
|
||||||
* Mandrake or Redhat : /etc/rc.d/init.d/postgresql start
|
|
||||||
|
|
||||||
* others: /usr/bin/postmaster -D /var/lib/pgsql/data or /usr/bin/pg_ctl
|
|
||||||
-D /var/lib/pgsq/data start (adjust for your install dirs)
|
|
||||||
|
|
||||||
* create the empty database: /usr/bin/createdb phpgroupware
|
|
||||||
|
|
||||||
* create a database user: /usr/bin/createuser phpgroupware
|
|
||||||
|
|
||||||
For more detailed user documentation on Postgresql see their
|
|
||||||
website : [http://www.postgresql.org]
|
|
||||||
|
|
||||||
4.5 Setup / Configure phpGroupWare
|
|
||||||
|
|
||||||
Point your browser to http://yourserverroot/phpgroupware/setup/
|
|
||||||
which will create (or upgrade) the header.inc.php and database
|
|
||||||
tables. Setup will attempt to determine what version of
|
|
||||||
the phpGroupWare databases and header.inc.php you have installed,
|
|
||||||
and upgrade to the most recent version.
|
|
||||||
|
|
||||||
Note: You are advised to backup your existing database before
|
|
||||||
running the setup script to avoid problems!
|
|
||||||
|
|
||||||
4.6 Testing the install
|
|
||||||
|
|
||||||
If your config is setup properly you can now login. Point
|
|
||||||
your browser to the installed location and login with the
|
|
||||||
username demo and the password is 1234
|
|
||||||
|
|
||||||
At this point it would be a good idea to create a new user
|
|
||||||
with administrative privileges and delete the old one.
|
|
||||||
|
|
||||||
4.7 Installing additional applications
|
|
||||||
|
|
||||||
Once you have the core phpGroupWare install up and running,
|
|
||||||
you may want to download and install additional applications.
|
|
||||||
|
|
||||||
You should consult any README or INSTALL files that come
|
|
||||||
with the new application first, as most require you to create
|
|
||||||
additional tables in the database, and add additional translation
|
|
||||||
data to the lang table (typically a file called lang.sql)
|
|
||||||
|
|
||||||
You install the new application within the phpGroupWare install
|
|
||||||
tree by copying the application directory into the phpGroupWare
|
|
||||||
install location, and enabling the application through the
|
|
||||||
Administration page.
|
|
||||||
|
|
||||||
For example, this is the process to install the Headlines
|
|
||||||
application:
|
|
||||||
|
|
||||||
(see [http://www.sourceforge.net/projects/phpgwapps]
|
|
||||||
for more applications)
|
|
||||||
|
|
||||||
Download the .tar.gz file for the application, or check out
|
|
||||||
the source with cvs with
|
|
||||||
|
|
||||||
export CVSROOT=':pserver:anonymous@cvs.phpgroupware.sourceforge.net:/cvsroot/phpgwapps'
|
|
||||||
|
|
||||||
cvs login (just hit enter if prompted for a password)
|
|
||||||
|
|
||||||
cvs co headlines
|
|
||||||
|
|
||||||
Move the headlines directory into your phpGroupWare install
|
|
||||||
directory.
|
|
||||||
|
|
||||||
Log into phpGroupWare as an administrative user, and go to
|
|
||||||
the Administration page.
|
|
||||||
|
|
||||||
In the first section, choose the Applications link.
|
|
||||||
|
|
||||||
Click on add, and fill in the form.
|
|
||||||
|
|
||||||
Application name should be identical to the name of the directory
|
|
||||||
you moved into the phpGroupWare install, in this case use
|
|
||||||
headlines
|
|
||||||
|
|
||||||
Application Title is shown in the navigation bar and other
|
|
||||||
places to refer to the new application. Enter Headlines
|
|
||||||
for this example.
|
|
||||||
|
|
||||||
Enabled can be used to disable an application for all users
|
|
||||||
temporially. You should normal check the box to enable the
|
|
||||||
application.
|
|
||||||
|
|
||||||
Back in the Administration page, you need to enable the application
|
|
||||||
for specific users or user groups by editing them, and checking
|
|
||||||
the new Headlines box that appears in the middle of the
|
|
||||||
account editing page.
|
|
||||||
|
|
||||||
Once you have added the Headlines app to your account, you
|
|
||||||
should see a Headlines entry in the Administration and Preferences
|
|
||||||
pages, and there should be an icon for the Headlines application
|
|
||||||
in the navigation bar.
|
|
||||||
|
|
||||||
Once you enable a few of the Headlines sites through the
|
|
||||||
Administration page link, you should see headlines grabbed
|
|
||||||
from the sites you selected when you click on the Headlines
|
|
||||||
icon in the navigation bar.
|
|
||||||
|
|
||||||
5 Trouble Shooting
|
|
||||||
|
|
||||||
Warning
|
|
||||||
|
|
||||||
phpGroupWare is still Beta software, expect some bugs along
|
|
||||||
the way. If you run into a problem not discussed here, contact
|
|
||||||
us through one of the methods listed on the website.
|
|
||||||
|
|
||||||
The phpGroupWare developers can most often be seen hanging
|
|
||||||
out in #phpGroupWare on irc.openprojects.net if you require
|
|
||||||
real-time help.
|
|
||||||
|
|
||||||
Also check the FAQ in this directory for additional common
|
|
||||||
questions, it is available as FAQ.sgml, FAQ.txt and FAQ.html
|
|
||||||
|
|
||||||
5.1 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 more than a few hundred messages in your
|
|
||||||
mailbox.
|
|
||||||
|
|
||||||
By default, php is set up to time-out a request that takes
|
|
||||||
over 30 seconds to complete. phpGroupWare must do a lot
|
|
||||||
of work the first time your POP3 mailbox is opened, and
|
|
||||||
every time you get new mail, which may take more than the
|
|
||||||
30 second timeout.
|
|
||||||
|
|
||||||
You can either clean up your mailbox with another mail program,
|
|
||||||
or add the line
|
|
||||||
|
|
||||||
set_time_limit(0);
|
|
||||||
|
|
||||||
to the top of the phpgwapi/inc/phpgw_msg_pop3.inc.php file,
|
|
||||||
just before the line class msg extends msg_common
|
|
||||||
|
|
||||||
If you choose to edit the file, be patient when loading a
|
|
||||||
large POP3 mailbox - the author tested against a mailbox
|
|
||||||
with 2500 messages in it, but it took 15 minutes to load
|
|
||||||
the page. We highly suggest you use IMAP if you expect to
|
|
||||||
have more than a few hundred messages in your mailbox.
|
|
||||||
|
|
||||||
5.2 When I log in I see the directory listing instead of a
|
|
||||||
web page
|
|
||||||
|
|
||||||
You are using Apache, this often means you need to add .php
|
|
||||||
to the DirectoryIndex line in your httpd.conf file. For
|
|
||||||
example:
|
|
||||||
|
|
||||||
DirectoryIndex index.php index.php3 index.html index.htm
|
|
||||||
index.cgi
|
|
||||||
|
|
||||||
5.3 I get garbage that looks like code when I go to the phpGroupWare
|
|
||||||
URL
|
|
||||||
|
|
||||||
This is often because you have php3 installed, which does
|
|
||||||
not map .php to the PHP engine. For PHP3:
|
|
||||||
|
|
||||||
AddType application/x-httpd-php3 .php3 .php
|
|
||||||
|
|
||||||
For PHP4:
|
|
||||||
|
|
||||||
AddType application/x-httpd-php .php3 .php
|
|
||||||
|
|
||||||
6 About this document
|
|
||||||
|
|
||||||
The newest version of this document can be found on our website
|
|
||||||
[http://www.phpgroupware.org] as lyx source, HTML, or TEXT.
|
|
||||||
|
|
||||||
Comments on this HOWTO should be directed to the phpGroupWare
|
|
||||||
developers mailing list phpgroupware-developers@lists.sourceforge.net
|
|
||||||
|
|
||||||
To subscribe, go to _id=7305
|
|
||||||
|
|
||||||
6.1 History
|
|
||||||
|
|
||||||
This document was started by Joseph Engo reworked by Dan
|
|
||||||
Kuykendall then edited by Darryl VanDorp
|
|
||||||
|
|
||||||
6.2 Version History
|
|
||||||
|
|
||||||
Old Version
|
|
||||||
|
|
||||||
Created by Jengo, wasn't in SGML HOWTO format.
|
|
||||||
|
|
||||||
v1.0 (July 6, 2000)
|
|
||||||
|
|
||||||
Built proper SGML version.
|
|
||||||
|
|
||||||
Included the FAQ.
|
|
||||||
|
|
||||||
Other minor additions.
|
|
||||||
|
|
||||||
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
|
|
||||||
|
|
||||||
v0.01 (October 15 , 2000) - gnrfan , Converted the HOWTO
|
|
||||||
to DocBook format
|
|
||||||
|
|
||||||
v.0.05 (November 5, 2000) - gnrfan , Completely revamped
|
|
||||||
according to Seek's idea and intregrated the Developers
|
|
||||||
HOWTO.
|
|
||||||
|
|
||||||
v.0.06 (Jan 10, 2001) - Darryl VanDorp, imported to lyx source
|
|
||||||
reformatted and touched up some sections
|
|
||||||
|
|
||||||
v.0.07 (Jan 16, 2001) - Darryl VanDorp, added TOC, fixed
|
|
||||||
some Postgresql setup instructions, added some links to
|
|
||||||
install/compilation instructions for apache, php and mysql.`
|
|
||||||
|
|
||||||
v.0.08 (Feb 22, 2001) - Darryl VanDorp, added a multipart
|
|
||||||
html export
|
|
||||||
Loading…
Reference in New Issue
Block a user