|
From: Benjamin C. <bc...@us...> - 2001-10-14 03:25:27
|
Update of /cvsroot/phpbt/phpbt/docs/sgml In directory usw-pr-cvs1:/tmp/cvs-serv31660/sgml Modified Files: installation.sgml Log Message: Updated the installation instructions Index: installation.sgml =================================================================== RCS file: /cvsroot/phpbt/phpbt/docs/sgml/installation.sgml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- installation.sgml 2001/09/29 04:02:38 1.1 +++ installation.sgml 2001/10/14 03:25:23 1.2 @@ -1,63 +1,47 @@ <!-- -*- sgml -*- --> <sect1 id="installation"> - <title>Installation Instructions</title> +<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> +<procedure> +<step> +<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><command>cat</command> <filename>page.inc.patch</filename> | <command>patch</command> <option>-p0</option> <option>-b</option> <filename><replaceable>/path/to/phplib/page.inc</replaceable></filename></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> +<note> +<para>Optional: Install JpGraph (<ulink url="http://www.aditus.nu/jpgraph/">http://www.aditus.nu/jpgraph</ulink>) if you wish to use it for the summary bug display on the home page.</para> +</note> +</step> + +<step> +<para>Copy the directory tree from the tarball to a location suitable for serving web pages.</para> +</step> + +<step> +<para>Run <command>configure_db</command>, which will create <filename>createdb.sql</filename>. Use the <option>-h</option> option when running <command>configure_db</command> to see the options.</para> +</step> + +<step> +<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). You can also edit the options being inserted into the configuration table or edit them later from the web interface.</para> +</step> + +<step> +<para>Use <filename>createdb.sql</filename> to create your database. With MySQL it can be done as follows: +</para> +<screen><command>mysql</command> <option>-h</option> <replaceable>db host</replaceable> <option>-u</option> <replaceable>username</replaceable> <option>-p</option><replaceable>yourpassword</replaceable> < <filename>createdb.sql</filename></screen> +</step> + +<step> +<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> +</step> + +<step> +<para>Start reporting bugs.</para> +</step> - </orderedlist> +</procedure> </sect1> <!-- Local Variables: --> -<!-- sgml-indent-step: 2 --> -<!-- sgml-indent-data: 2 --> <!-- sgml-parent-document: "phpbt.sgml" --> <!-- End: --> |