[phpBT-dev] CVS: phpbt/docs/sgml installation.sgml,NONE,1.1 phpbt.sgml,1.1,1.2

[Benjamin C. <bc...@us...>]

Update of /cvsroot/phpbt/phpbt/docs/sgml
In directory usw-pr-cvs1:/tmp/cvs-serv15929/sgml

Modified Files:
	phpbt.sgml 
Added Files:
	installation.sgml 
Log Message:
Added the installation instructions

--- NEW FILE: installation.sgml ---
<!-- -*- sgml -*- -->
<sect1 id="installation">
  <title>Installation Instructions</title>

  <orderedlist>
    <listitem>
      <para>Install PHPlib (<ulink url="http://sourceforge.net/projects/phplib/">http://sourceforge.net/projects/phplib</ulink>) if it's not already installed.  Note that with recent versions of PHP, PHPlib needs to be patched.  Please do the following with the patch file, <filename>page.inc.patch</filename> in the distribution directory:</para>
      <screen>cat page.inc.patch | patch -p0 -b /path/to/phplib/page.inc</screen>
      <para>Make sure you replace <filename>/path/to/phplib</filename> with the actual path to the installation of PHPlib.  On windows systems you can edit <filename>page.inc</filename> and change line 67 from <computeroutput>if (isset($user)) {</computeroutput> to <computeroutput>if (isset($user) && $user) {</computeroutput>.</para>
    </listitem>

    <listitem>
      <para>Copy the directory tree from the tarball to a location suitable for serving web pages.</para>
    </listitem>

    <listitem>
      <para>Run the <filename>configure</filename> script.  This will change <filename>config.php</filename> (creating a backup) and will run <filename>configure_db</filename>, which will create <filename>createdb.sql</filename>. </para>

      <para><emphasis>-- or --</emphasis></para>

      <para>Configure manually:
	<orderedlist>
	  <listitem>
	    <para>Edit the constants in <filename>config.php</filename>.</para>
	  </listitem>
	  <listitem>
	    <para>Run <filename>configure_db</filename> to get <filename>createdb.sql</filename>.</para>
	  </listitem>
	</orderedlist>
      </para>
    </listitem>

    <listitem>
      <para>If you want to use JpGraph (<ulink url="http://www.aditus.nu/jpgraph/">http://www.aditus.nu/jpgraph</ulink>) to display the bug summary info, you will also need to edit <filename>jpgraph.php</filename> from the JpGraph disribution.</para>
    </listitem>

    <listitem>
      <para>Edit <filename>createdb.sql</filename>, changing the admin info in the database insert.  You can search on the text <computeroutput>ad...@ex...</computeroutput> (around line 240).</para>
    </listitem>

    <listitem>
      <para>Use <filename>createdb.sql</filename> to create your database.  With MySQL it can be done as follows:
      </para>
      <screen>mysql -h &lt;db host&gt; -u &lt;username&gt; -p&lt;yourpassword&gt; &lt; createdb.sql</screen>
    </listitem>

    <listitem>
      <para>Browse on over to the installation, choose Admin tools, login with the info you put in the database creation script, and create your first project.</para>
    </listitem>

    <listitem>
      <para>Start reporting bugs.</para>
    </listitem>

  </orderedlist>

</sect1>

<!-- Local Variables: -->
<!-- sgml-indent-step: 2 -->
<!-- sgml-indent-data: 2 -->
<!-- sgml-parent-document: "phpbt.sgml" -->
<!-- End: -->

Index: phpbt.sgml
===================================================================
RCS file: /cvsroot/phpbt/phpbt/docs/sgml/phpbt.sgml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- phpbt.sgml	2001/09/27 13:40:20	1.1
+++ phpbt.sgml	2001/09/29 04:02:38	1.2
@@ -5,6 +5,9 @@
 <!-- Shortcuts -->
 <!ENTITY phpbt "phpBugTracker">
 
+<!-- Administrator's Guide -->
+<!ENTITY installation SYSTEM "installation.sgml">
+
 <!-- Developer's Guide -->
 <!ENTITY devstandards SYSTEM "devstandards.sgml">
 <!ENTITY dependencies SYSTEM "dependencies.sgml">
@@ -31,6 +34,9 @@
     <abstract>
       <para>One of the main design goals of &phpbt; is to make installation and administration easy.  In fact, the difficulty of installing bugzilla was a key motivator for &phpbt;'s existence.</para>
     </abstract>
+
+    &installation;
+
   </chapter>
 
   <chapter id="devguide">