Dashboard > Non-Metrix Tech Tips > ... > GForge > Installing pre-requisites for GForge
Non-Metrix Tech Tips Log In   View a printable version of the current page.
Installing pre-requisites for GForge
Added by A. Mitchell, last edited by A. Mitchell on Sep 05, 2006  (view change)
Labels: 

This document assumes you have setup Debian on your server and that you are logged in as root. It describes how to install:

  • Apache 2
  • PHP4
  • PostgreSQL

See also:

Install PostFix

  1. Use apt to install it:
    apt-get install postfix
  2. Make sure to choose "Internet Site" as the configuration.
  3. Use your administrative username as the target address for all mail for root.
  4. Enter the full domain name for the "Mail name", e.g, gforge.fcny.org.
  5. Accept the defaults for other domain names (localhost.localdomain, etc.).
  6. Accept defaults on synchronous updates.
  7. Watch as Postfix installs itself as the new mail transfer agent.

To start, stop, and restart Postfix:

# postfix start
# postfix stop
# postfix reload

For info on configuring and troubleshooting Postfix, see this article.

On Debian, the mail log is stored in /var/log/mail.log, and you can see what messages are in the queue by executing mailq. You may also want to check /var/log/syslog.0.

Install FCNY's SWS with PHP4

Note: This won't work if you are not at FCNY. In such cases, you should install PHP4 from standard Debian packages instead.

  1. Use apt to install it:
    apt-get install sws
  2. Configure CVS when prompted, accepting the defaults.
  3. If prompted to replace the sshd with the package maintainer's, answer yes.
  4. Install SWS with PHP4:
    apt-get install sws-php4
  5. Accept defaults when prompted regarding the installation and configuration of PostgreSQL.

Install Apache 2

(not necessary if you've already installed SWS)

  1. Use apt to install it:
    # apt-get install apache2
  2. To restart Apache: /etc/init.d/apache2 restart

Configure Apache 2

There may be some configuration mishaps due to SWS, so just use this apache2.conf file instead of the one you have: apache2.conf.txt

Install Mailman

  1. Use apt to install it:
    # apt-get install mailman
  2. Accept default languages.
  3. Create a "sitelist":
    newlist mailman
  4. Enter the email address of the person running the list.
  5. Set an initial password.
  6. Restart mailman:
    /etc/init.d/mailman start
  7. You will need to configure Mailman so it can receive and respond to email, and so that its admin web pages are acessible. How do we do this?
  8. You will need to configure Mailman so that it's web pages are accessible via the webserver. How do we do this?

For details, see

Install PostgreSQL

(not necessary if you've already installed SWS)

  1. Install the PostgreSQL package
    # apt-get install postgresql
  2. During the setup, accept the default data location (/var/lib/postgres/data)
  3. Choose en_us for the locale of the database backend.
  4. Choose US date formatting.
  5. Change the password for the postgres user:
    # passwd postgres

Test PostgreSQL

(See http://glasnost.beeznest.org/articles/218 for excellent tips)

  1. Create the user gforge on the system, and as the user postgres, allow gforge to create databases in Postgres.
    # adduser gforge
    # su postgres
    # createuser gforge
    ...
    CREATEUSER
    #
  2. Open PostgreSQL's security configuration file so that it allows connections from local users:
    # nano /etc/postgresql/pg_hba.conf
  3. Edit the file replacing every "IDENT" with "TRUST" ( What is the more secure way of doing this?)
  4. Exit the file (ctl-x) and restart Postgres:
    # /etc/init.d/postgresql restart
  5. Attempt to connect to the Postgres server as the new user. This command will connect and list all databases:
    # psql -h localhost -U gforge -W -l
  6. Attempt to create a new database on the server:
    # createdb -h localhost -U gforge -W metrixtest
  7. Connect to the newly created database:
    # psql -h localhost -U gforge -W metrixtest
  8. Make sure you can return SQL:
    # select 2 + 2;
  9. Exit the Postgres client:
    # \q

Install PHP4

(not necessary if you've already installed SWS)

  1. Use apt to install it:
    # apt-get install libapache2-mod-php4
  2. Install PHP4's PostgresSQL module
    # apt-get install php4-pgsql
  3. Make sure PHP4 is working by creating a PHP page with this directive and accessing it in your browser:
    <?php phpinfo(); ?>

Configure PHP4

  1. Get the path to the ini file from the "Configuration File (php.ini) Path" on your phpinfo page.
    # nano /etc/php.ini
  2. Edit PHP's configuration file to turn "Register Globals" on, so that GForge will work.
    register_globals = On
  3. Restart Apache so the changes will take effect in the PHP module:
    apache2ctl restart

Install and configure Subversion

(not necessary if you've already installed SWS)

  1. Use apt to install it:
    # apt-get install subversion

    See http://www.debian-administration.org/articles/374 for more info.

Continue

That's it. You are now ready to move on to Installing GForge.

Site powered by a free Open Source Project / Non-profit License (more) of Confluence - the Enterprise wiki.
Learn more or evaluate Confluence for your organisation.
Powered by Atlassian Confluence, the Enterprise Wiki. (Version: 2.1.1 Build:#406 Dec 23, 2005) - Bug/feature request - Contact Administrators