egroupware_official/doc/sgml/installation.sgml

<part label="II">
 	
	<title>Installation</title>
<partintro>
	<para>

<literallayout>
Installation/Upgrade and Configuration of phpGroupWare has been made as easy as possible. 
Most of the work is point and click. 
By carefully reading this document you can easly install phpGroupWare.
</literallayout>
	</para>
	<para>
		Since this is still a beta version we do expect some bugs.
	</para>
</partintro>
	
<chapter id="requirements">
		<title>Requirements</title>
		<para>
		You will need PHP compiled and installed on your system.  You will also need MySQL, PostgreSQL or Oracle setup.
		</para>
		<para>
		If you are planning on using the email system, you will need to have an IMAP server installed and IMAP support compiled into PHP, or a POP3 server installed.
		You can have it installed as an Apache module or CGI mode for other web servers, 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.
		</para>
	<simplesect>
		<title>Tested Systems</title>
		<para>
		Seek3r has tested:
		<itemizedlist mark=bullet>
		  <listitem><para>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</para></listitem>
    </itemizedlist>

		Blinky has tested:
		<itemizedlist mark=bullet>
		  <listitem><para>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</para></listitem>
    	<listitem><para>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.</para></listitem>
    </itemizedlist>


		Jengo has tested:
		<itemizedlist mark=bullet>
		  <listitem><para>main test box: Red Hat 6.2,Apache 1.3.12,PHP 3.0.16,PostgreSQL 7.2,Sendmail (from RH6.2)</para></listitem>
    	<listitem><para>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</para></listitem>
    	<listitem><para>Test box: Win2k with IIS5.0, PHP4.0.2 and MySQL</para></listitem>
    </itemizedlist>
 		There are installations on Windows NT and OS/2, and using MySQL or Oracle as the database.
 		</para>
	</simplesect>
</chapter>
<chapter id="obtaining">
	<title>Obtaining phpGroupWare</title>
		<para>
			While we are still in the Beta phase of phpGroupWare, you may
			want to track the CVS copy as closely as possible. The released
			versions are more stable, but often contain bugs that have been fixed
			in the CVS version.
		</para>
	<simplesect>
			<title>Released Versions</title>
			<para>
				The downloads section on the <ulink url="http://www.phpgroupware.org/"><citetitle>site</citetitle></ulink>
				contains links to the most recent releases, and several mirror sites
				for the releases.
			</para>
	</simplesect>
	<simplesect>
			<title>Developer's version from CVS</title>
			<para>
				If you have never used CVS, you may want to read through the doucmentation
				found at <ulink url="http://www.cvshome.org/"><citetitle>www.cvshome.org</citetitle>
				</ulink>.
				The CVS pages for the core and apps projects can be found at
				<ulink url="http://sourceforge.net/cvs/?group_id=7305">
				<citetitle>phpGroupWare Core CVS</citetitle></ulink>
				, and <ulink url="http://sourceforge.net/cvs/?group_id=9787">
				<citetitle>phpGroupWare Apps CVS</citetitle></ulink>.
				Follow the directions for <emphasis>Anonymous CVS access</emphasis> and you should
				have the most recent development copy of phpGroupWare in no time.
			</para>
	</simplesect>
</chapter>
&installing;	
&troubleshoot;
</part>