Set up the environment for an advanced CollabNet TeamForge installation

Prepare the hardware, operating system and networking setup that your site will require.

You must have root-level access to the machine where you are installing CollabNet TeamForge

If you anticipate heavy use of your site, you may want to consider installing the database or the source control service on a separate server. See Set up the database for your CollabNet TeamForge site on a separate server or Set up source control on its own server.

Install the operating system according to the instructions from the OS provider. For information about the operating systems you can use with CollabNet TeamForge, see Platform information for TeamForge 5.4.
Note: Do not customize your installation. Select only the default packages list.
Important: If you are installing CentOS, you must uninstall the PostgreSQL support package and the Dovecot mail server to clear the way for TeamForge to install PostgreSQL. These packages are installed as part of the default CentOS install. Use these commands:
- rpm -qa | grep dovecot | xargs rpm -e
- rpm -qa | grep postgresql-libs | xargs rpm -e
Make sure port 80 is open.
Tip: For detailed firewall requirements, see Which ports should I keep open?
Verify that the machine name is resolvable on the network.
1. Use the hostname command to verify the name of the machine.
  - hostname
  - bigbox.supervillain.org
2. Use the nslookup command to verify that your hostname maps to the right IP address.
  - nslookup bigbox.supervillain.org
  - Server: 204.16.107.137
  - Address: 204.16.107.137#53
  Tip: If there is any doubt about what the system's real IP address is, use the /sbin/ifconfig command.
If any mail service is running on port 25, stop it and make sure it won't restart. For example:
- /sbin/service sendmail stop
- /sbin/chkconfig sendmail off
If you are installing behind a proxy, specify your proxy settings now.
- export http_proxy=http://<PROXY_USERNAME>:<PROXY_PASSWD>@<PROXY_HOST>:<PROXY_PORT>
If you are using SElinux, make sure your SElinux settings are in order. See Set up SELinux for the recommended settings.
If you are installing TeamForge on SuSE Linux, take these extra steps.
Note: Skip this if you plan to install without an internet connection. It will be handled by the special installer package you will be downloading.
1. Register the machine with Novell.
  - suse_register -i -a email=<MailID> -a regcode-sles=<Registration code>
  where <MailID> is the email address associated with your SuSE Linux Enterprise Server license and <Registration code> is the Suse Enterprise Linux license code.
  
  Tip: You may need to run this command twice.
2. Move the existing installer repository out of the way.
  - cd /etc/zypp/repos.d/
  - mv SUSE-Linux-Enterprise-Server-11-0.repo SUSE-Linux-Enterprise-Server-11-0.repo_old
3. Enable the correct Novell repository. Open nu_novell_com:SLES11-Pool.repo in a text editor and change enabled=0 to enabled=1.
4. Refresh zypper.
  - Zypper ref
If you are installing TeamForge on CentOS without an Internet connection, move the Web-connected install repositories out of the way.
- mv CentOS-Base.repo CentOS-Base.repo.backup
- mv CentOS-Media.repo CentOS-Media.repo.backup
This will prevent CentOS from going to the Web for files, which could cause an error.

Your server is ready. You can now set up the software environment in which you will install CollabNet TeamForge.