Install TeamForge, Database, SCM, and EventQ on Four separate servers

Four-server distributed setup with TeamForge, Database (including Datamart), SCM (Subversion CVS and Git) and EventQ on four separate servers.

Dos and Don'ts

Check this list before installing or upgrading TeamForge.

Four Server Setup

Here's how the services are distributed across four separate RHEL/CentOS 7.4 servers.
Services TeamForge Application Server (server-01) EventQ Server (server-02) Database Server (server-03) SCM and Git Integration Server (server-04)
ctfcore
     
mail
     
search
     
codesearch
     
etl
     
gerrit      
gerrit-database      
reviewboard
     
reviewboard-database
     
reviewboard-adpater
     
subversion      
cvs      
binary
     
binary-database
     
cliserver
     
eventq  
   
mongodb  
   
redis  
   
rabbitmq  
   
ctfcore-database    
 
ctfcore-datamart    
 

Do this step by step on 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. Configure your TeamForge installation repository.
  4. Install the following application packages.
    1. TeamForge: To install the TeamForge application packages run the following command:
      • yum install teamforge

Important: The following warning message, which shows up during TeamForge install/upgrade (while installing CN-eventq rpm) can be safely ignored.
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
...
...
Errno::ENOENT: No such file or directory - git
...
...

  1. Install Review Board (note that you should have added the following identifiers to the SERVICES token: reviewboard, revieboard-database, and reviewboard-adapter).
    • yum install CN-reviewboard

    For more information, see Install Review Board on the TeamForge Application Server.

Do this step by step on Database 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. Configure your TeamForge installation repository.
  4. Install the TeamForge database packages.
    • yum install teamforge-database
  5. Set up your site's master configuration file.
  6. 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 step by step on TeamForge Application Server (server-01)

  1. Copy the site-options.conf file from the Database Server to the TeamForge Application Server's /opt/collabnet/teamforge/etc/ directory.
  2. 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 step by step on the SCM and Git Integration Server (server-04)

  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. Configure your TeamForge installation repository.
  4. Install the TeamForge SCM and Git packages.
    • yum install teamforge-scm teamforge-git
  5. Copy the site-options.conf file from the Database Server (server-03) to the SCM and Git Integration Server's /opt/collabnet/teamforge/etc/ directory.
  6. 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.

    During teamforge provision, the Register SCM integration process fails on sites that use self-signed certificates. Perform these steps in such cases.

    1. Restart JBoss on the TeamForge Application server.
      • teamforge restart -s jboss
    2. Reinitialize TeamForge on the SCM server.
      • teamforge reinitialize

Do this step by step on EventQ server (server-02)

  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. Configure your installation repository.
  4. Install the EventQ packages.
    • yum install teamforge-eventq

Important: The following warning message shows up when you run yum install teamforge, which can be safely ignored.
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.

  1. Copy the site-options.conf file from the Database Server (server-03) to the EventQ Server's /opt/collabnet/teamforge/etc/ directory.
  2. 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 step by step on TeamForge 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.

Post Installation Tasks