Set up the environment for a dedicated 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

  1. 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
  2. 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.
  3. 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.
  4. Make sure port 80 is open.
    Tip: For detailed firewall requirements, see Which ports should I keep open?
  5. If you are installing behind a proxy, specify your proxy settings now.
    • export http_proxy=http://<PROXY_USERNAME>:<PROXY_PASSWD>@<PROXY_HOST>:<PROXY_PORT>
  6. 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
  7. Disable SELinux.
Your server is ready. You can now set up the software environment in which you will install CollabNet TeamForge.