Revision as of 09:00, 29 April 2009

(This page is a work in progress)

System requirements

FusionForge is mainly developed on Linux systems, but it should run on other Unix variants as well. The minimal required components are Apache 2, PHP 5 and PostgreSQL 8.x. Other components may be needed depending on the extra features you need: Mailman for mailing-lists, CVS or SVN for version control, and so on.

Installation

Packages

There are *.deb packages available for Debian and derivatives such as Ubuntu. The official Debian repositories contain packages of the latest FusionForge release (4.7.2) for Debian unstable. The "experimental" section also contains snapshots of the release-candidates for 4.8 during the stabilisation period. Users of Ubuntu or other versions of Debian will find instructions on how to get the packages on Installing/DebianRepositories or Installing/UbuntuRepositories ).

• .rpm packages are being worked on, and they will be advertised as soon as they're considered ready.

Installation CD

If you have a server you want to fully dedicate to FusionForge, then the installation CD could be for you: just boot the server on it, and it'll perform an automated installation of Debian + FusionForge. Grab the image at Installing/InstallCD

VMware image

Also easy to use is the VMware image, which you'll also find at Installing/VMwareImage

"Manual" installation

Finally, there's the non-packaged way of installing FusionForge: grab the tarball at Installing/RedhatCentosTarballs , then run the install.sh script.

Debian Lenny Installation Procedure

• BASIC PREPARATIONS
  • Create a hostname for your web site (ex. FORGE.YOURSITE.COM)
  • Configure Apache to answer to requests for this hostname
  • Test Apache by browsing to your URL to see the default Apache "It works." page
  • Do the following steps as root user

• INSTALL EXIM4

apt-get update
apt-get install exim4

• INSTALL MAILMAN

apt-get install mailman

• Create required mailman list and start mailman

newlist mailman
/etc/init.d/mailman start

• INSTALL POSTGRESQL(latest version)

apt-get install postgresql

• Test using Create Language:

su postgres
createlang plpgsql template1
exit

• Change authentication method for pgsql:

cp /etc/postgresql/8.3/main/pg_hba.conf /etc/postgresql/8.3/main/pg_hba.confbak
nano  /etc/postgresql/8.3/main/pg_hba.conf

Change:

All other connections by UNIX sockets
local  all  all        '''ident sameuser'''

All IPv4 connections from localhost
host  all  all  127.0.0.1  255.255.255.255  '''ident sameuser'''

All IPv6 localhost connections
host  all  all  ::1  ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff  '''ident sameuser'''
host  all  all    ::ffff:127.0.0.1/128  '''ident sameuser'''

To:

All other connections by UNIX sockets
local  all  all        '''password'''

All IPv4 connections from localhost
host  all  all  127.0.0.1  255.255.255.255  '''password'''

All IPv6 localhost connections
host  all  all  ::1  ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff  '''password'''
host  all  all    ::ffff:127.0.0.1/128  '''password'''

• INSTALL PHP5

Edit /etc/apt/sources.list and add the following and save:

# PHP5 Source
deb http://packages.dotdeb.org stable all
deb-src http://packages.dotdeb.org stable all

As the root user, execute:

apt-get update
	
apt-get install libapache2-mod-php5 libapache2-mod-perl2 php5 php5-cli 
php5-common php5-curl php5-dev php5-gd php5-imap php5-ldap php5-mhash 
php5-mysql php5-odbc php5-xsl

Some packages may fail, but as they do, remove them from your list of installations until apt-get install runs successfully. There are only a couple of core modules that are required.

To check your version of PHP, issue the following command:

php -v

To test PHP, do the following:

cd /var/www (if www is not your webroot, substitute)
nano test.php (creates file called test.php)

Add the following to the file:

<?php
phpinfo();
?>

Browse to your webroot with your web browser: http://yoursite.com/test.php You should see php configuration information on the screen. If you do, then you can be certain php is running on your server and is being loaded into Apache correctly. For security purposes, make sure you DELETE the test.php file immediately.

• INSTALL SVN

apt-get install subversion

• INSTALL WEBMIN

deb http://download.webmin.com/download/repository sarge contrib
apt-get update
apt-get install webmin

OR

wget http://prdownloads.sourceforge.net/webadmin/webmin_1.470_all.deb
dpkg --install webmin_1.470_all.deb

If Debian complains about missing dependencies, you can install them with the command:

apt-get install perl libnet-ssleay-perl openssl libauthen-pam-perl 
libpam-runtime libio-pty-perl libmd5-perl

Download POSTGRESQL Webmin Module This will help in administering the database via a GUI if you aren't comfortable using commands.

• INSTALL FUSIONFORGE

Visit Installing/DebianRepositories or Installing/UbuntuRepositories for additional install packages

deb http://fusionforge.fusionforge.org/debian lenny main
deb-src http://fusionforge.fusionforge.org/debian lenny main

wget -q http://fusionforge.fusionforge.org/key -O- | sudo apt-key add -
apt-get update
apt-get install gforge

Package Maintainer's Version for all prompts

• INSTALL SCM PLUGIN

apt-get install gforge-plugin-scmsvn

• INSTALL MEDIAWIKI PLUGIN

apt-get install gforge-plugin-mediawiki

Enable wiki for project by navigating to Project>Admin>Edit Public Info and check off the box for Mediawiki

Procedure by Narayan Raum and Chris Barnes at the University of Florida.

Back to FusionForge