1 This is an install report for sourceforge 2.5 (debian-sf) to gforge 3.1
2 The various problem encountered can be of some help for those of us doing
4 Thanks to Jeremy Maziarz
5 Originaly downloaded from
6 http://members.cox.net/jmaziarz/tmp/HOWTO-sourceforge-gforge-transition.txt
8 --------------------------------------------------------------
11 AUTH: jmaziarz@mitre.org
12 DESC: This document describes the process used to transition a working
13 SourceForge 2.5 installation to GForge 3.1 using the available Debian
17 1. Backup your SourceForge 2.5 installation (database, LDAP, etc.).
19 ** This cannot be stressed enough. Installing the GForge transition package
20 ** can and will overwrite or could destroy anything that is not backed up.
23 2. Modify your /etc/apt/sources.list
25 # vi /etc/apt/sources.list
27 Add the following lines:
29 deb http://gforge.free.fr/debian stable/
30 deb-src http://gforge.free.fr/debian stable/
35 3. Install the gforge-sourceforge-transition Debian package
37 # apt-get install gforge-sourceforge-transition
41 ** This is where I encountered my first problem. Below you will see that
42 ** /etc/gforge/local.pl could not be found. That is because it doesn't
43 ** exist yet, so we need to make it exist! See solution #1, below.
45 sf:~# apt-get install gforge-sourceforge-transition
46 Reading Package Lists... Done
47 Building Dependency Tree... Done
48 The following NEW packages will be installed:
49 gforge-sourceforge-transition
50 0 packages upgraded, 1 newly installed, 0 to remove and 5 not upgraded.
51 Need to get 53.4kB of archives. After unpacking 119kB will be used.
52 Get:1 http://gforge.free.fr stable/ gforge-sourceforge-transition 3.1-0woody2 [53.4kB]
53 Fetched 53.4kB in 10s (5197B/s)
54 Selecting previously deselected package gforge-sourceforge-transition.
55 (Reading database ... 28382 files and directories currently installed.)
56 Unpacking gforge-sourceforge-transition (from .../gforge-sourceforge-transition_3.1-0woody2_all.deb) ...
57 Setting up gforge-sourceforge-transition (3.1-0woody2) ...
58 Can't locate /etc/gforge/local.pl at -e line 1.
59 dpkg: error processing gforge-sourceforge-transition (--configure):
60 subprocess post-installation script returned error exit status 2
61 Errors were encountered while processing:
62 gforge-sourceforge-transition
63 E: Sub-process /usr/bin/dpkg returned an error code (1)
67 ** Use the SourceForge local.pl file. Reinstall gforge-sourceforge-transition
70 # cp /etc/sourceforge/local.pl /etc/gforge/
71 # apt-get install gforge-sourceforge-transition
74 4. Install the gforge Debian package
76 ** During this install you will be asked for the Debian (Woody) CDs (1, 2
79 ** The installation of GForge is documented in serveral places so please
80 ** refer to that documentation for the actual GForge install steps.
82 # apt-get install gforge
84 ** Take note that during the GForge installation there is one screen
85 ** titled "Configuring Mailman" that says:
90 . Mailman needs a so-called "site list", which is the list from which .
91 . password reminders and such are sent out from. This list needs to be .
92 . created before mailman will start. .
94 . To create the list, run "newlist mailman" and follow the instructions .
99 ** This really would not be a problem if you took note of the screen I
100 ** mentioned above. But, in case you didn't here is what you might see:
102 Creating config file /etc/mailman/qmail-to-mailman.py with new version
103 cp -f /usr/share/mailman/qmail-to-mailman.py /etc/mailman/qmail-to-mailman.py
104 Upgrading from version 0x2000bf0 to 0x20102f0
105 getting rid of old source files
106 Site list for mailman (usually named mailman) missing
107 Please create it; until then, mailman will refuse to start
109 dpkg: dependency problems prevent configuration of gforge-lists-mailman:
111 < a bunch of dependancy messages cut out >
113 E: Sub-process /usr/bin/dpkg returned an error code (1)
117 ** Just as the screen I mentioned say run newlist. Restart the PostGreSQL
118 ** server and reinstall the gforge Debian package.
120 # /usr/sbin/newlist mailman
121 # /usr/sbin/invoke-rc.d postgresql start
122 # apt-get install gforge
125 5. Check to see if the database was imported properly.
127 ** There are two places that you can check to see if your SourceForge 2.5
128 ** database dump was imported into the new GForge database properly.
130 a. /var/lib/gforge/sf_dump_for_gforge.*
132 If sf_dump_for_gforge.ko exists then something failed.
133 If sf_dump_for_gforge.ok exists then it most likely was successful.
135 b. Check the database
137 sf:~# psql -c "SELECT sum(*) FROM users;" -U gforge gforge
143 If you have only two users then this result might be good, but I am
144 willing to bet that there are more, so something must have failed. ;)
147 6. Manually import the database (optional)
149 ** This of course only needs to be done if Step 5 indicates failure.
151 # cd /var/lib/gforge/
152 # /usr/share/gforge/bin/install-db.sh restore sf_dump_for_gforge.ko
154 ** Reinstall the gforge-db-postgresql Debian package (this will bring the
155 ** database schema up-to-date.
157 # apt-get install gforge-db-postgresql --reinstall