<?xml version='1.0' encoding='UTF-8'?>
-<!-- This document was created with Syntext Serna Free. -->
-<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "../../../dtd/docbookx.dtd" [
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "../../../dtd/docbookx.dtd" [
<!ENTITY % authors SYSTEM "../entities/authors.ent">
%authors;
]>
For instance, an installation of FusionForge hosts over 450 users and over 140 projects on a single CPU Pentium 2.4GHz machine with 512 MB of RAM.
</para>
<para>
- You can find additionnal information about hardware used by several installations of FusionForge in the <ulink url="http://gforge.org/docman/view.php/1/52/gforge-sites.html">FusionForge sites list maintained by Tom Copeland</ulink>.
+ You can find additionnal information about hardware used by several installations of GForge in the <ulink url="http://gforge.org/gf/download/docmanfileversion/105/1798/gforge-sites.html">old GForge sites list that used to be maintained by Tom Copeland</ulink>.
</para>
</section>
<section>
</para>
<orderedlist>
<listitem>
- <para>Linux Operating System</para>
+ <para>GNU/Linux Operating System</para>
</listitem>
<listitem>
<para><ulink url="http://www.postgresql.org/">PostgreSQL</ulink> 8.3 or later (8.1, 8.2 should work)</para>
<section>
<title>Overview</title>
<important>
- <para>The <filename>INSTALL</filename> file in FusionForge package and <filename>README</filename> files in plugin directories are the authoritive sources for installation instructions and they should have more precedence over this guide.</para>
+ <para>The <filename>INSTALL</filename> file in FusionForge package and <filename>README</filename> files in plugin directories are the authoritative sources for installation instructions and they should have more precedence over this guide.</para>
</important>
<note>
<para>This installation guide is for FusionForge 5.0.</para>
</section>
<section>
<title>Installing FusionForge on Debian</title>
- <para>
+<!-- FIXME : this is absolete now and should be fixed --> <para>
You can simply add lines found at <ulink url="http://debian.fusionforge.org/"/> to <filename>/etc/apt/sources.list</filename> and type <command>apt-get install fusionforge</command> to install a working FusionForge system, thanks to Christian Bayle and Roland Mas.
</para>
<para>
</para>
</section>
<section>
- <title>Installing Gforge on RPM-based systems</title>
+ <title>Installing FusionForge on RPM-based systems</title>
<para>RPM should be available soon, see <ulink url="http://fusionforge.org/"/> website for availability.</para>
</section>
<section>
<section>
<title>Getting the source</title>
<para>There is two ways to get the sources from FusionForge : </para>
- <screen>
+<!-- FIXME : this is absolete now and should be fixed --> <screen>
# <userinput>tar -xjvf fusionforge-5.0.tar.bz2</userinput>
# <userinput>cd fusionforge-5.0</userinput>
# <userinput>mkdir -p /opt/gforge</userinput>
<listitem>
<para>a Debian: postgresql, postgresql-contrib</para>
</listitem>
- <listitem>
- <para>a Red Hat 4 : postgresql, postgresql-contrib</para>
- </listitem>
</orderedlist>
</section>
<section>
<section>
<title>Importing Database</title>
<para>Create FusionForge database user:</para>
- <screen>
+<!-- TODO : should probably use fusionforge and not gforge below, now --> <screen>
# <userinput>su - postgres</userinput>
$ <userinput>psql template1</userinput>
template1=# <userinput>CREATE USER gforge NOCREATEUSER NOCREATEDB</userinput>
</section>
<section>
<title>Configuring DNS Server (BIND)</title>
- <para>FusionForge needs its own domain. In example FusionForge configuration file, it's <literal>gforge.<replaceable>company.com</replaceable></literal>. You should search for <replaceable>company.com</replaceable> in example FusionForge configuration file and replace it with your domain name.</para>
+ <para>FusionForge needs its own domain. In example FusionForge configuration file, it's <literal>gforge.<replaceable>company.com</replaceable></literal><!-- TODO: s/gforge/fusionforge/g -->. You should search for <replaceable>company.com</replaceable> in example FusionForge configuration file and replace it with your domain name.</para>
<para>Here some example configuration files for BIND are presented that can help you if you are not familiar with BIND but it's not meant to be complete. Don't ask BIND-related questions in FusionForge forums, consult documentation that come with your distribution and search in Internet. Distributions put files in different places and so there are no file locations here. The example configuration below is only quick start example and doesn't include reverse mapping.</para>
<para>For DNS, you need to have the bind package installed</para>
<para>New subdomain in <literal>gforge.<replaceable>company.com</replaceable></literal> should be created. In <replaceable>company.com</replaceable> zone file, it may look like that:</para>
noreply: /dev/null
</programlisting>
<para>Make sure that the following domain names are accepted as local destinations by mail transport agent:</para>
- <itemizedlist>
+<!-- TODO: s/gforge/fusionforge/g --> <itemizedlist>
<listitem>
<para><literal>gforge.<replaceable>company.com</replaceable></literal></para>
</listitem>
<para>Set <varname>$sys_custom_path</varname> configuration variable to <filename class="directory">/etc/gforge/custom</filename>.</para>
</listitem>
<listitem>
- <para>Copy <filename><replaceable>/var/www/gforge</replaceable>/www/index_std.php</filename> to <filename>/etc/gforge/custom/index_std.php</filename> and edit it as you like.</para>
+ <para>Copy <filename><replaceable>/usr/share/gforge</replaceable>/www/index_std.php</filename> to <filename>/etc/gforge/custom/index_std.php</filename> and edit it as you like.</para>
</listitem>
</orderedlist>
</section>
</itemizedlist>
</section>
<section>
- <title>JPGraph</title>
+ <title>JPGraph (Gantt Charting and Graphing Support)</title>
<para>PHP must be compiled with <literal>--with-gd</literal>, or appropriate package must be installed. Extra fonts for JPGraph are not necessary. Be sure your <filename>/etc/gforge/local.inc</filename> file contains the proper path to the <filename class="directory">jpgraph/src/</filename> directory.</para>
<para>Manual installation can be done like this:</para>
<screen>
<section>
<title>Perl</title>
<para>If you want to use some of the Perl scripts that access the database, you'll need the <literal>DBI</literal> and <literal>DBD::Pg</literal> Perl modules. On Red Hat systems (and variants), you can get them by installing the <literal>libdbi</literal> and <literal>libdbd-pgsql</literal> packages. On Debian systems (and variants), the packages are called <literal>libdbi-perl</literal> and <literal>libdbd-pg-perl</literal>.</para>
- <para>You'll also need to install <filename>utils/include.pl</filename> to <filename class="directory">/usr/share/gforge/lib/</filename>, and put some configuration variables into <filename class="directory">/etc/gforge/local.pl</filename>. In particular, you'll need something like the following in <filename>local.pl</filename>:</para>
- <programlisting>
-$sys_default_domain = 'gforge.company.com' ;
-$sys_dbhost = '192.168.12.34' ;
-$sys_dbname = 'gforge' ;
-$sys_dbuser = 'gforge' ;
-$sys_dbpasswd = 'p455w0rd' ;
-</programlisting>
+ <para>You'll also need to install <filename>utils/include.pl</filename> to <filename class="directory">/usr/share/gforge/lib/</filename>.</para>
</section>
<section>
<title>Jabber Support</title>
<section>
<title>Plugins</title>
<note>
- <para>Since FusionForge 4.0, plugins are necessary as source code management is now provided by plugins (SCM* plugins).</para>
+ <para>Since GForge 4.0, plugins are necessary as source code management is now provided by plugins (SCM* plugins).</para>
</note>
<para>For each plugin, you can find an <filename>INSTALL</filename> file in the plugin tarball.</para>
<section>
<para>You may also be missing GD support or be missing JPGraph or have it installed improperly. The <filename class="directory">jpgraph/src/</filename> directory should be specified accurately in your <filename class="directory">local.inc</filename> file, and you should include a <filename>/</filename> at the end of the path specified. In addition, you should modify <filename>jpgraph.php</filename> to set <literal>USE_CACHE=false</literal>.</para>
<para>Q: How do I upgrade my database?</para>
<para>A: As stated above, you must apply the changes that are listed in date order in the <filename class="directory">db/</filename> directory to your database. Only the changes that are not already in your old <filename class="directory">db/</filename> directory should be applied, and they should be applied and checked <emphasis>in order</emphasis>.</para>
- <para>Q: I'm getting an error about BaseLanguage.class.php not being found.</para>
- <para>A: Make sure your localization path is correctly specified in the local.inc file and that it is readable <emphasis>and</emphasis> writable by the apache user.</para>
<para>Q: When I click on <quote>/projects/</quote> or <quote>/users/</quote> links, I get the source code instead of the page I expected.</para>
<para>A: As shown in the example <filename>httpd.conf</filename> files above, you may have to switch to using the <literal><Files></literal> or <literal><Location></literal> directives depending on your server version.</para>
<para>Q: How do I backup FusionForge?</para>