Install TeamForge, SCM and Git integration, and EventQ on separate servers

Three-server distributed setup with TeamForge (including Database and Datamart), SCM (Subversion and CVS) and Git, and EventQ services installed on RHEL/CentOS 7.4 servers.

Before you begin:

Remember:

  • TeamForge 17.11 supports both RHEL/CentOS 6.9 and 7.4. See TeamForge installation requirements
  • For the ETL service to run as expected in a distributed TeamForge installation, all servers must have the same time zone.
  • While you can run both EventQ and TeamForge on the same server, CollabNet recommends such an approach only for testing purposes. It's always recommended to run EventQ on a separate server for optimal scalability. See EventQ installation requirements.
  • Installing or upgrading TeamForge needs root privileges. You must log on as root or use a root shell to install or upgrade TeamForge.
The following table shows the distribution of services on different servers.
App Server: server-01 SCM and Git Integration Server: server-03
TeamForge Application Server (ctfcore) SCM Integration Server (subversion and cvs)
Mail Server (mail) Git Integration Server (gerrit and gerrit-database)
Codesearch Server (codesearch)  
Database Server (ctfcore-database and ctfcore-datamart)
ETL Server (etl)  
Search Server (search)  
EventQ Server: server-02
TeamForge EventQ Server (eventq, mongodb, redis and rabbitmq)

Do this on the TeamForge Application Server (server-01)

  1. Install Red Hat Enterprise Linux/CentOS 7.4 and log on as root.

    The host must be registered with the Red Hat Network if you are using Red Hat Enterprise Linux.

    See the Red Hat installation guide for help.

  2. Check your basic networking setup. See Set up Networking for more information.
  3. If the TeamForge server has SELinux enabled, run it in 'permissive' mode temporarily while installing or upgrading TeamForge.

    If you have SELinux in "enforcing" mode, you must either disable SELinux or switch to "permissive" mode (recommended) before running the teamforge provision command. TeamForge create runtime fails otherwise.

    1. Verify if SELinux is running in enforcing mode.
      • getenforce
    2. If the output of the getenforce command is "permissive", continue with the next step. If not, run the following command to bring it to 'permissive' mode.
      • setenforce 0
  4. Configure your TeamForge installation repository.
  5. Install the following application packages.
    1. TeamForge: To install the TeamForge application packages run the following command:
      • yum install teamforge
  6. Set up your site's master configuration file.
  7. Provision services.
    • teamforge provision
    Note:

    TeamForge 17.4 (and later) installer expects the system locale to be LANG=en_US.UTF-8. TeamForge "provision" command fails otherwise.

Do this on the SCM and Git Integration Server (server-03)

  1. Install Red Hat Enterprise Linux/CentOS 7.4 and log on as root.

    The host must be registered with the Red Hat Network if you are using Red Hat Enterprise Linux.

    See the Red Hat installation guide for help.

  2. Check your basic networking setup. See Set up Networking for more information.
  3. If the TeamForge server has SELinux enabled, run it in 'permissive' mode temporarily while installing or upgrading TeamForge. TeamForge create runtime fails otherwise.
    1. Verify if SELinux is running in enforcing mode.
      • getenforce
    2. If the output of the getenforce command is either "Disabled" or "Permissive", SELinux is already disabled.
    3. If not disabled, run the following command to bring it to 'permissive' mode.
      • setenforce 0
  4. Configure your TeamForge installation repository.
  5. Install the TeamForge SCM and Git packages.
    • yum install teamforge-scm teamforge-git
  6. Copy the site-options.conf file from the TeamForge Application Server to the SCM and Git Integration Server's /opt/collabnet/teamforge/etc/ directory.
  7. Configure the services and domain name tokens.
    server-03:SERVICES = subversion cvs gerrit gerrit-database
    server-03:PUBLIC_FQDN = my.scmandgit.domain.com
    server-01:SERVICES = ctfcore ctfcore-database mail codesearch search etl ctfcore-datamart binary binary-database reviewboard reviewboard-database
  8. Provision services.
    • teamforge provision
    Note:

    TeamForge 17.4 (and later) installer expects the system locale to be LANG=en_US.UTF-8. TeamForge "provision" command fails otherwise.

Do this on the TeamForge Application Server (server-01)

  1. Run the TeamForge post installation script. For more information, see post-install.py.
    Important: If the token REQUIRE_USER_PASSWORD_CHANGE is set to true, login to TeamForge user interface, change the admin password and then run the post-install.py script.
    • /opt/collabnet/teamforge/runtime/scripts/post-install.py
  2. Restart TeamForge.
    • teamforge restart

Do this on the EventQ server (server-02)

  1. Install EventQ. See EventQ installation walk-through

Do this on the Application Server (server-01)

  1. Verify TeamForge installation.
    1. Reboot the server and make sure all services come up automatically at startup.
    2. Log on to the TeamForge web application using the default Admin credentials.
      • Username: "admin"
      • Password: "admin"
    3. Create a sample project. See Create a TeamForge project
    4. Write a welcome message to your site's users. See Create a site-wide broadcast.