FusionForge

Difference between revisions of "Installing"

From FusionForge Wiki
Jump to: navigation, search
(Replacing page with 'This page has been moved to Catergory:Install')
Line 1: Line 1:
(This page is a work in progress)
+
This page has been moved to [[:Catergory:Install]]
 
 
== 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 for Debian unstable (in the experimental section for now).  Users of Ubuntu or other versions of Debian will find instructions on how to get the packages on http://fusionforge.fusionforge.org/ (in the Debian or Ubuntu tabs).
 
 
 
*.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 http://fusionforge.fusionforge.org/
 
 
 
=== VMware image ===
 
Also easy to use is the VMware image, which you'll also find at http://fusionforge.fusionforge.org/
 
 
 
=== "Manual" installation ===
 
Finally, there's the non-packaged way of installing FusionForge: grab the tarball, 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'''
 
<pre>
 
apt-get update
 
apt-get install exim4
 
</pre>
 
 
 
* '''INSTALL MAILMAN'''
 
<pre>
 
apt-get install mailman
 
</pre>
 
* Create required mailman list and start mailman
 
<pre>
 
newlist mailman
 
/etc/init.d/mailman start
 
</pre>
 
 
 
* '''INSTALL POSTGRESQL(latest version)'''
 
<pre>
 
apt-get install postgresql
 
</pre>
 
* Test using Create Language:
 
<pre>
 
su postgres
 
createlang plpgsql template1
 
exit
 
</pre>
 
* Change authentication method for pgsql:
 
<pre>
 
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
 
</pre>
 
 
 
'''Change:'''
 
<pre>
 
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'''
 
</pre>
 
 
'''To:'''
 
<pre>
 
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'''
 
</pre>
 
 
 
* INSTALL PHP5
 
 
 
Edit /etc/apt/sources.list and add the following and save:
 
<pre>
 
# PHP5 Source
 
deb http://packages.dotdeb.org stable all
 
deb-src http://packages.dotdeb.org stable all
 
</pre>
 
As the root user, execute:
 
<pre>
 
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
 
</pre>
 
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:
 
<pre>php -v</pre>
 
 
 
To test PHP, do the following:
 
<pre>cd /var/www (if www is not your webroot, substitute)
 
nano test.php (creates file called test.php)</pre>
 
Add the following to the file:
 
<pre>
 
<?php
 
phpinfo();
 
?></pre>
 
 
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
 
<pre>apt-get install subversion</pre>
 
 
 
 
 
* INSTALL WEBMIN
 
<pre>
 
deb http://download.webmin.com/download/repository sarge contrib
 
apt-get update
 
apt-get install webmin
 
</pre>
 
OR
 
<pre>
 
wget http://prdownloads.sourceforge.net/webadmin/webmin_1.470_all.deb
 
dpkg --install webmin_1.470_all.deb
 
</pre>
 
If Debian complains about missing dependencies, you can install
 
them with the command:
 
<pre>
 
apt-get install perl libnet-ssleay-perl openssl libauthen-pam-perl
 
libpam-runtime libio-pty-perl libmd5-perl
 
</pre>
 
Download POSTGRESQL Webmin Module
 
This will help in administering the database via a GUI if you aren't
 
comfortable using commands.
 
 
 
* INSTALL FUSIONFORGE
 
Visit http://fusionforge.fusionforge.org for additional install packages
 
<pre>
 
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
 
</pre>
 
Package Maintainer's Version for all prompts
 
 
 
* INSTALL SCM PLUGIN
 
<pre>apt-get install gforge-plugin-scmsvn</pre>
 
 
 
* INSTALL MEDIAWIKI PLUGIN
 
<pre>apt-get install gforge-plugin-mediawiki</pre>
 
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.''
 
 
 
 
 
[[Category:Install]]
 

Revision as of 13:36, 18 April 2009

This page has been moved to Catergory:Install