SourceForge Installation Guide - Introduction

[Résumé] [Copyright]

# 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.

[Résumé] [Copyright]

SourceForge Installation Guide