|
From: Benjamin C. <bc...@us...> - 2001-09-29 04:02:41
|
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 <db host> -u <username> -p<yourpassword> < 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">
|