Install TeamForge 6.1.1 the easy way

The easiest way to install TeamForge is to install on a single box, dedicated to TeamForge only, taking the default configuration settings. We call this a "dedicated" install.

Important: It is critical that you start with a fresh machine, with no software installed apart from the boot loader. You must have root access to the server.

Install SuSE Linux Enterprise Server 11 SP1 and log in as root.
- See Platform specification for TeamForge 6.1.1 for the full platform requirements.
- See the SuSE Linux Enterprise Server deployment guide for help.
Important: Don't customize your installation. Select only the default packages list.
Check your basic networking setup. See Set up networking for your TeamForge box for details.
Set up the SuSE repository.
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.
2. Move the existing installer repository out of the way.
  - cd /etc/zypp/repos.d/
  - mv SUSE-Linux-Enterprise-Server-11-SP1\ 11.1.1-1.152.repo SUSE-Linux-Enterprise-Server-11-SP1\ 11.1.1-1.152.repo_old
3. Make sure the correct Novell repository is enabled. Open nu_novell_com:SLES11-SP1-Pool.repo in a text editor and confirm that enabled=1.
4. Refresh zypper.
  - Zypper ref
Note: As an alternative, you can insert the SuSe Linux Enterprise Server DVD.
- Ensure that the DVD is mounted in the location specified by the baseurl variable in SUSE-Linux-Enterprise-Server-11-SP1\ 11.1.1-1.152.repo.
- Use zypper info postgresql to check that the DVD is properly mounted.
Download the TeamForge 6.1.1 installation repository from open.collab.net. Copy it to /etc/zypp/repos.d/.
Install the TeamForge application.
- zypper install teamforge-sles
Set up your site's master configuration file.
- vi /opt/collabnet/teamforge-installer/6.1.1.0/conf/site-options.conf
Note: vi is given as an example. Emacs, gedit, or any other *nix text editor will also work.

At this stage, we'll make the minimal modifications required to set up a usable TeamForge 6.1.1 site.
1. Edit the DOMAIN_localhost variable to point the site's URL to the server where the site is running. Use this format:
  - DOMAIN_localhost=<domain_name>
  For example, suppose SuperVillain Inc. wants its development site to have the URL https://worlddomination.supervillain.org. The DOMAIN_localhost variable will look like this:
  - DOMAIN_localhost=worlddomination.supervillain.org
2. Review the DATABASE variables. You may want to substitute your own values for the default database names, user names and passwords.
3. Turn on the new site-wide reporting functionality by adding the REPORTS_* variables. See Turn on site-wide reporting for details.
4. If you don't specify a domain name, replace the HOST_localhost token with the hostname. Otherwise, ViewVC pages for Subversion and CVS repositories created after the site is up, will be rendered with a CSS error.
5. Important: It is mandatory that you include the SCM_DEFAULT_SHARED_SECRET token in the site-options.conf file of the primary TeamForge server, and give it a value of 16-24 characters.
  Remember that you need to use that same key in the external SCM integration server also.
Run the installer.
- cd /opt/collabnet/teamforge-installer/6.1.1.0
- ./install.sh -r -I -V
Set up the initial site data.
- ./bootstrap-data.sh
Start TeamForge.
- /etc/init.d/collabnet start
Apply some finishing touches and make sure everything is running smoothly.
1. Turn on SSL for your site by editing the relevant variables in the site-options.conf file. See Set up SSL for your TeamForge site.
2. Reboot the server and make sure all services come up automatically at startup.
3. Log into your site as the administrator. The value of the DOMAIN variable in the site-options.conf file is the URL to log into.
4. Install a project template. TeamForge comes with a sample project template that showcases some of the platform's most interesting features. Site administrators and project managers can use this template to jump-start projects without a lot of manual setup steps. See Install project templates.
5. Create a sample project. See Create a TeamForge project.
6. Write a welcome message to your site's users. See Create a site-wide broadcast.