Gforge on debian 4.0, Configuration (Part 1)

This article is my experience when I installed gforge on my debian systems

Before install the gforge there are several things that must set up first
These is what I had done

For you who using a standalone PC and a server which is not registered yet on internet or on their local networks

Login as a root

First.

set your hostname at /etc/hostname into nameserver you want
on this example I used

awaludin.org

Second

Install and configure the dns server

# apt-get install bind

Configure dns server

add these lines into /etc/bind/named.conf

zone "awaludin.org" {
	type master;
	file "/etc/bind/awaludin.org";
};
zone "177.13.10.in-addr.arp" {
	type master;
	file "/etc/bind/177.13.10.reverse";
};

Create file /etc/bind/awaludin.org

# vi /etc/bind/awaludin.org

and put these lines into /etc/bind/awaludin.org

 ; ——————————————————-
$TTL    604800
@       IN      SOA     awaludin.org. root.awaludin.org. (
		1           ; Serial
		604800         ; Refresh
		86400         ; Retry
		2419200         ; Expire
		604800 )       ; Negative Cache TTL
;
@       IN      NS       awaludin.org.
@       A       10.13.177.60
www     A       10.13.177.60
scm     A       10.13.177.60
lists   A       10.13.177.60

Create file /etc/bind/177.13.10-reverse

# vi /etc/bind/177.13.10-reverse

and put these lines into /etc/bind/177.13.10-reverse

; ———————————————————
$TTL    604800
@       IN      SOA     awaludin.org. root.awaludin.org. (
		1         ; Serial
		604800    ; Refresh
		86400     ; Retry
		2419200   ; Expire
		604800 )  ; Negative Cache TTL
;
@       IN      NS      awaludin.org.
60      IN      PTR     awaludin.org.
60      IN      PTR     scm.awaludin.org.
60      IN      PTR     lists.awaludin.org.

Check every configurations

# named-checkconf /etc/bind/named.conf
# named-checkzone awaludin.org /etc/bind/awaludin.org
# named-checkzone 177.13.10.in-addr.arp /etc/bind/177.13.10.reverse

Start the services

# /etc/init.d/bind9 start

and if it already runs, restart it

# /etc/init.d/bind9 restart

Third

Install the mod-ssl and create the certificate

# apt-get install libapache-mod-ssl
# mod-ssl-makecert

When you’re making a certificate there is step when you are asked for phrase , please remember this phrase carefully , because when you start or restart apache server , it will demand the phrase

Fourth

Set up your hosts at /etc/hosts
add these lines into /etc/hosts

10.13.177.60	awaludin.org
10.13.177.60	www.awaludin.org
10.13.177.60	scm.awaludin.org
10.13.177.60	lists.awaludin.org

Fifth

Install proftp and configure it

# apt-get install proftpd

Please read the dialog carefully during the installation, choose “inetd”

Edit /etc/proftpd/proftpd.conf and find this line

UseIPv6				on

And change it into

UseIPv6				off

Restart the proftpd to take effects

# /etc/init.d/proftpd restart

Sixth

WARNING !!!

If you had a web files before, probably it won’t work well, because gforge systems edit the “include_path” on php.ini
If you want your web run smoothly, please make virtual hosts
and you could consulate it with me, perhaps I could help.

Seventh

Install apache’s modules

The modules that needed here is libapache2-mod-php and libapache2-svn
you could use libapache2-mod-php5 or libapache-mod-php4

# apt-get install libapache2-mod-php4
or
# apt-get install libapache2-mod-php5

# apt-get install libapache2-svn

Activate the module that had been installed

# a2enmod php4
or
# a2enmod php5

# a2enmod dav_svn

Eighth

Install gforge

# apt-get install gforge

During the installation, you will asked for your gforge admin password, fill it and don’t you musn’t forget it.
Follow the installation carefully, When the phrase asked to you fill with the sama phrase when you make certificate before

If you enter a wrong phrase it will asked the phrase again
but If the phrase you entered is right but it’s said “failed”. It is mean you have patch this patch below (notice: please change a text “awaludin.org” on the patch into your own domain name)

here is the patch:

--- /etc/gforge/httpd.conf	2007-09-28 14:08:56.000000000 +0700
+++ /root/pacth/httpd.conf	2007-09-28 14:07:23.000000000 +0700
@@ -248,78 +248,6 @@
   ServerName lists.awaludin.org
   AddHandler cgi-script .cgi

-  ScriptAlias /mailman/ /var/lib/mailman/cgi-bin/
-
-  Alias /pipermail /var/lib/mailman/archives/public
-
-    AllowOverride Options
-    Options FollowSymLinks
-
-
-  Alias /images/mailman /usr/share/images/mailman
-
-    order allow,deny
-    allow from all
-
-
-  RedirectMatch permanent ^/$ http://lists.awaludin.org/mailman/listinfo
-  LogFormat "%h %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" gforge
-  CustomLog "|/usr/bin/cronolog /var/log/gforge/%Y/%m/%d/gforge.log" gforge
-  # Ensure that we don't try to use SSL on SSL Servers
-
-    SSLDisable
-
-
-
-# HTTPS
-
-  ServerName lists.awaludin.org
-  AddHandler cgi-script .cgi
-
-
-    SSLEngine on
-    SSLCertificateFile /etc/apache/ssl.crt/server.crt
-    SSLCertificateKeyFile /etc/apache/ssl.key/server.key
-
-      SSLOptions +StdEnvVars
-
-
-      SSLOptions +StdEnvVars
-
-    SetEnvIf User-Agent ".*MSIE.*" nokeepalive ssl-unclean-shutdown
-
-
-
-    SSLEnable
-
-
-  ScriptAlias /mailman/ /var/lib/mailman/cgi-bin/
-
-  Alias /pipermail /var/lib/mailman/archives/public
-
-    AllowOverride Options
-    Options FollowSymLinks
-
-
-  Alias /images/mailman /usr/share/images/mailman
-
-    order allow,deny
-    allow from all
-
-
-  RedirectMatch permanent ^/$ https://lists.awaludin.org/mailman/listinfo
-  LogFormat "%h %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" gforge
-  CustomLog "|/usr/bin/cronolog /var/log/gforge/%Y/%m/%d/gforge.log" gforge
-
-
-#
-# List host
-#
-# HTTP
-
-  ServerName lists.awaludin.org
-  AddHandler cgi-script .cgi
-
   ScriptAlias /cgi-bin/mailman/ /var/lib/mailman/cgi-bin/

   Alias /pipermail /var/lib/mailman/archives/public

Save the patch into /home/httpd.conf.patch

# cp /etc/gforge/httpd.conf /etc/gforge/httpd.conf.backup
# cd /etc/gforge
# patch -p3 < /home/httpd.conf.patch

Restart apache2 server

# /etc/init.d/apache2 restart

If your server not running, please send your /etc/gforge/httpd.conf .backup to me at xblank_id@yahoo.com

If the server works well
open the browser and type “http://awaludin.org” (please type the url according to your own domain setting at /etc/hostname)

Login as admin and enter the password that you have made during the gforge installation (at step Eighth)

you still couldn’t use svn because we have’nt installed gforge-plugin-scmsvn yet

try it yourself

perhaps I will cover it up someday with this article next part

to be continued…………..