SourceForge Installation Guide - Chapitre 1
Introduction

1.1 Summary

This document is intended to be a complete installation and configuration guide for the SourceForge code. Since this code is very dependent from the archictecture, we had to choose one. Therefore this document focuses on a "one-machine" SourceForge. It is likely to be the most popular architecture. However, we hope that this document will be useful if you intend to distribute all SourceForge services on more boxes.

1.2 Acknowledgements

I would like to thank Roland Mas and Sam Gasster for their help and corrections and all the Alcôve crew for their support and testing.

Of course, I thank the developpers of SourceForge for their amazing development tool.

1.3 Generic installation

1.3.1 Requirements

You will need to get the Sourceforge 2.0 source code. In this document, this is the only supported version. You'll find it at http://sourceforge.net/projects/alexandria/.

You need to choose a root for sourceforge. I suggest that you choose something like /sfroot. This root will be noted as SF_ROOT in the rest of this document.

Furthermore if you want to use all the SourceForge features such as DNS or Mail, you have to choose a domainname. This domain name will be refered as DOMAIN_NAME. This domain can be either regular or just virtual. That is to say that you can either register a domain name (such as sourceforge.net) via a registrar or use a completely virtual domain name (like sourceforge.internal) which will just exist on your private network. Either way, we do recommend that you setup a DNS for your domain. The procedure is explained later.

1.3.2 Procedure

Run the following commands in a root shell

		# mkdir SF_ROOT
		# cd SF_ROOT
		# tar xvzf 'path'/SF2_0.tar.gz
		# mv SF2.0/* .
		# rmdir SF2.0

Get the patch and the images tar file at http://zoy.org/~guillaum/SF/. Detar the images archive. At this time, check that a ftp group exists if not you will have to create it. Then run

	# cd SF_ROOT
	# cp good_path/ad.gif www/images
	# cp good_path/clear.gif www/images
	# gzip -cd path_of_the_patch | patch -p1
	# chmod 755 guide/*
	# guide/mkdirs.sh
	# guide/perms.sh (the user under which Apache runs) (the group under which Apache runs)
	# cd www
	# ../guide/fix_news.pl

This creates the required dirs with correct permissions and remove the hardcoded number of the SF news group.