FusionForge Manual Tom Copeland <[email protected]> Roland Mas <[email protected]> Ken McCullagh Tim Perdue Guillaume Smet <[email protected]> Reinhard Spisser <[email protected]> FusionForge Manual by Tom Copeland, Roland Mas, Ken McCullagh, Tim Perdue, Guillaume Smet, and Reinhard Spisser Table of Contents 1. Introduction ................................................................................................................... 1 About FusionForge ..................................................................................................... 1 FusionForge History ................................................................................................... 1 FusionForge Installation Guide ............................................................................................. 3 Hardware Requirements ............................................................................................... 3 Software Requirements ................................................................................................ 3 Installation ................................................................................................................ 4 Overview .......................................................................................................... 4 Installing FusionForge on Debian .......................................................................... 4 Installing Gforge on RPM-based systems ................................................................ 4 Installing FusionForge oneself on a linux distribution ................................................ 4 Configuring the Database (PostgreSQL) ................................................................. 6 Configuring DNS Server (BIND) .......................................................................... 8 Configuring PHP ................................................................................................ 9 Configuring the Web Server (Apache) .................................................................... 9 Configuring Mail Transport Agent (Any) .............................................................. 12 File Release System (FRS) ................................................................................. 13 Configuring GNU Mailman ................................................................................ 13 Source Code Management (SCM) ........................................................................ 14 Cron Jobs ........................................................................................................ 14 Verifying the Installation .................................................................................... 15 Creating the Admin User ................................................................................... 15 Customizing Front Page ..................................................................................... 16 Optional Features .............................................................................................. 16 Plugins .................................................................................................................... 20 CVS ............................................................................................................... 20 CVSTracker ..................................................................................................... 22 SVN ............................................................................................................... 23 Upgrading Existing Install .......................................................................................... 24 Most Common Problems ............................................................................................ 24 FusionForge Administration Guide ....................................................................................... 26 Introduction ............................................................................................................. 26 What is FusionForge? ................................................................................................ 26 What can FusionForge do for me? ............................................................................... 26 Setting up a new project ............................................................................................ 26 Registering a new project ........................................................................................... 27 Administering a new project ....................................................................................... 27 CVS repository ......................................................................................................... 27 Setting up the CVSROOT .......................................................................................... 27 Setting your .rhosts file correctly ............................................................................ 27 Creating the CVS repository ....................................................................................... 28 FusionForge User Guide .................................................................................................... 30 Introduction ............................................................................................................. 30 Getting Started ................................................................................................. 30 User specific functions ....................................................................................... 30 Project specific functions ................................................................................... 30 Site-wide functions ............................................................................................ 31 Getting Started ......................................................................................................... 31 FusionForge homepage ...................................................................................... 31 Registering as a new user ................................................................................... 31 Registering a new project ................................................................................... 32 iii FusionForge Manual Login .............................................................................................................. 33 Logout ............................................................................................................ 33 User specific functions ............................................................................................... 33 User Homepage ................................................................................................ 33 Modifying User settings ..................................................................................... 34 Changing the language on FusionForge ................................................................. 34 User ratings ..................................................................................................... 34 Skills profile .................................................................................................... 34 Diary and Notes ............................................................................................... 34 Project functions ....................................................................................................... 35 Project Summary .............................................................................................. 35 Project Activity ................................................................................................ 35 Project Administration ....................................................................................... 35 Forums ............................................................................................................ 38 Tracker ........................................................................................................... 40 Mailing Lists .................................................................................................... 45 Task Manager .................................................................................................. 45 Document Manager ........................................................................................... 47 Surveys ........................................................................................................... 48 News .............................................................................................................. 49 CVS ............................................................................................................... 50 File Releases .................................................................................................... 50 Blocks ............................................................................................................ 52 Site-wide functions ................................................................................................... 53 Introduction ..................................................................................................... 53 Searching in FusionForge ................................................................................... 54 Trove map ....................................................................................................... 54 Snippet Library ................................................................................................ 54 Project