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

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

Dos and Don'ts

Check this list before installing or upgrading TeamForge.

Three Server Setup

Here's how the services are distributed across three separate RHEL/CentOS 7.3 servers.
Services TeamForge Application Server (server-01) EventQ Server (server-02) SCM and Git Integration Server (server-03)
ctfcore
   
mail
   
search
   
codesearch
   
etl
   
gerrit    
gerrit-database    
reviewboard
   
reviewboard-database
   
reviewboard-adapter
   
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.3 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 application packages.
    • 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. Set up your site's master configuration file.
  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 SCM and Git Integration Server (server-03)

  1. Install Red Hat Enterprise Linux/CentOS 7.3 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 TeamForge Application Server 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 and Git server.
      • teamforge reinitialize

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

  1. Install Red Hat Enterprise Linux/CentOS 7.3 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 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 TeamForge Application Server (server-01) 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. Restart TeamForge.
    • teamforge restart
  2. 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