This document assumes you have setup Debian on your server and that you are logged in as root. It describes how to install:
See also:
Install PostFix
- Use apt to install it:
- Make sure to choose "Internet Site" as the configuration.
- Use your administrative username as the target address for all mail for root.
- Enter the full domain name for the "Mail name", e.g, gforge.fcny.org.
- Accept the defaults for other domain names (localhost.localdomain, etc.).
- Accept defaults on synchronous updates.
- 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.
- Use apt to install it:
- Configure CVS when prompted, accepting the defaults.
- If prompted to replace the sshd with the package maintainer's, answer yes.
- Install SWS with PHP4:
- Accept defaults when prompted regarding the installation and configuration of PostgreSQL.
Install Apache 2
(not necessary if you've already installed SWS)
- Use apt to install it:
# apt-get install apache2
- 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
- Use apt to install it:
# apt-get install mailman
- Accept default languages.
- Create a "sitelist":
- Enter the email address of the person running the list.
- Set an initial password.
- Restart mailman:
/etc/init.d/mailman start
- 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?
- 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)
- Install the PostgreSQL package
# apt-get install postgresql
- During the setup, accept the default data location (/var/lib/postgres/data)
- Choose en_us for the locale of the database backend.
- Choose US date formatting.
- Change the password for the postgres user:
Test PostgreSQL
(See http://glasnost.beeznest.org/articles/218
for excellent tips)
- 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
#
- Open PostgreSQL's security configuration file so that it allows connections from local users:
# nano /etc/postgresql/pg_hba.conf
- Edit the file replacing every "IDENT" with "TRUST" (
What is the more secure way of doing this?)
- Exit the file (ctl-x) and restart Postgres:
# /etc/init.d/postgresql restart
- 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
- Attempt to create a new database on the server:
# createdb -h localhost -U gforge -W metrixtest
- Connect to the newly created database:
# psql -h localhost -U gforge -W metrixtest
- Make sure you can return SQL:
- Exit the Postgres client:
Install PHP4
(not necessary if you've already installed SWS)
- Use apt to install it:
# apt-get install libapache2-mod-php4
- Install PHP4's PostgresSQL module
# apt-get install php4-pgsql
- Make sure PHP4 is working by creating a PHP page with this directive and accessing it in your browser:
Configure PHP4
- Get the path to the ini file from the "Configuration File (php.ini) Path" on your phpinfo page.
- Edit PHP's configuration file to turn "Register Globals" on, so that GForge will work.
- Restart Apache so the changes will take effect in the PHP module:
Install and configure Subversion
(not necessary if you've already installed SWS)
- 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.