Install Review Board on your site before you can make it available as an integrated application to project managers on your TeamForge site.
You can install the Review Board application (reviewboard) on the TeamForge Application Server or on a seprate server of its own.

Review Board database (reviewboard-database) can be installed on the TeamForge PostgreSQL Database Server on sites with database running on a separate server.

To install Review Board successfully, ensure that other repositories such as EPEL (Extra Packages for Enterprise Linux) are disabled apart from the CollabNet and Operating System repositories.

This procedure is for those who are installing the Review Board for the first time.

In this scenario, both TeamForge and Review Board use PostgreSQL.

TeamForge 18.1 supports Review Board 2.5.6.1 on RHEL/CentOS 6.9 and 7.4.

Installing Review Board needs root privileges. You must log on as root or use a root shell to install Review Board.

Install Review Board on the TeamForge Application Server

In this setup, you install Review Board on the TeamForge Application Server (server-01) that already has TeamForge installed on it.

  1. If you have TeamForge installed, you should have the TeamForge installation repository configured already.

    For more information, see:

    TeamForge Installation Repository Configuration for Sites with Internet Access

    1. Contact the CollabNet Support and download the TeamForge 18.1 installation repository package to /tmp.
    2. Install the repository package.
      yum install -y /tmp/collabnet-teamforge-repo-18.1-0-noarch.rpm
      
    3. Refresh your repository cache.
      yum clean all
      

    TeamForge Installation Repository Configuration for Sites without Internet Access

    1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 18.1 disconnected installation and save it in /tmp.
      • RHEL/CentOS 7.4 64 bit: CTF-Disconnected-media-18.1.446-1261.rhel7.x86_64.rpm
      • In addition to the above CentOS 7.4 64 bit RPM package, you must get the following CentOS 7.4 compatibility RPM, which is required for TeamForge 18.1 disconnected media installation on CentOS 7.4 profile: compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm.
    2. Unpack the disconnected installation package.
      rpm -ivh <package-name>
      
    3. Unpack the compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm package if you are installing TeamForge 18.1 on CentOS 7.4.
      rpm -ivh compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
      
    4. If not mounted already, mount the RHEL/CentOS installation DVD.

      The DVD contains the necessary software and utilities required for installing TeamForge without internet access. In the following commands, replace “cdrom” with the identifier for your server’s CD/DVD drive, if necessary.

      cd /media/
      mkdir cdrom
      mount /dev/cdrom ./cdrom/
      

      If there are any spaces in the automount, unmount it first and mount it as a filepath, with no spaces.

    5. Create a yum configuration file that points to the RHEL/CentOS installation DVD.
      vi /etc/yum.repos.d/cdrom.repo
      

      Here’s a sample yum configuration file.

      [RHEL-CDROM]
      name=RHEL CDRom 			
      baseurl=file:///media/cdrom/Server/
      gpgfile=file:///media/cdrom/RPM-GPG-KEY-redhat-release 
      enabled=1
      gpgcheck=0
      
    6. Verify your yum configuration files.
      yum list httpd
      yum list apr
      
  2. Install Review Board.
    yum install teamforge
    
  3. Make sure that reviewboard, reviewboard-database and reviewboard-adapter identifiers have been added to the SERVICES token of the TeamForge Application Server.
    server-01:SERVICES=ctfcore ctfcore-database mail search codesearch etl ctfcore-datamart subversion cvs gerrit gerrit-database binary binary-database reviewboard reviewboard-database reviewboard-adapter cliserver
    
  4. Do this on sites without internet access.
    1. Contact the CollabNet Support and get the python-modules-sources.zip file.
    2. Unzip the python-modules-sources.zip file to /opt/collabnet/teamforge/service/reviewboard/resources/SOURCES/python-modules-sources.
      unzip python-modules-sources.zip -d /opt/collabnet/teamforge/service/reviewboard/resources/SOURCES/python-modules-sources
      
  5. Provision services.
    teamforge provision
    
  6. If SCM is installed on a separate box, run the following script to authenticate a scmviewer user against a TeamForge Subversion repository for creating a new review request.
    python ./svn-auth.py --repo-path=https://<scm_domain>/svn/repos/<repo_dir_name>
    

    You should now have a Review Board instance ready to work with TeamForge.


Install Review Board with Database on a Separate Server

You can install the Review Borad database on the TeamForge Database Server on sites with a dedicated Database Server. In this setup, you install TeamForge and Review Board on a two-server distributed setup with database services running on a separate server.

Install Review Board services on the TeamForge Application Server (server-01)

  1. If you have TeamForge installed, you should have the TeamForge installation repository configured already.

    For more information, see:

    TeamForge Installation Repository Configuration for Sites with Internet Access

    1. Contact the CollabNet Support and download the TeamForge 18.1 installation repository package to /tmp.
    2. Install the repository package.
      yum install -y /tmp/collabnet-teamforge-repo-18.1-0-noarch.rpm
      
    3. Refresh your repository cache.
      yum clean all
      

    TeamForge Installation Repository Configuration for Sites without Internet Access

    1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 18.1 disconnected installation and save it in /tmp.
      • RHEL/CentOS 7.4 64 bit: CTF-Disconnected-media-18.1.446-1261.rhel7.x86_64.rpm
      • In addition to the above CentOS 7.4 64 bit RPM package, you must get the following CentOS 7.4 compatibility RPM, which is required for TeamForge 18.1 disconnected media installation on CentOS 7.4 profile: compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm.
    2. Unpack the disconnected installation package.
      rpm -ivh <package-name>
      
    3. Unpack the compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm package if you are installing TeamForge 18.1 on CentOS 7.4.
      rpm -ivh compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
      
    4. If not mounted already, mount the RHEL/CentOS installation DVD.

      The DVD contains the necessary software and utilities required for installing TeamForge without internet access. In the following commands, replace “cdrom” with the identifier for your server’s CD/DVD drive, if necessary.

      cd /media/
      mkdir cdrom
      mount /dev/cdrom ./cdrom/
      

      If there are any spaces in the automount, unmount it first and mount it as a filepath, with no spaces.

    5. Create a yum configuration file that points to the RHEL/CentOS installation DVD.
      vi /etc/yum.repos.d/cdrom.repo
      

      Here’s a sample yum configuration file.

      [RHEL-CDROM]
      name=RHEL CDRom 			
      baseurl=file:///media/cdrom/Server/
      gpgfile=file:///media/cdrom/RPM-GPG-KEY-redhat-release 
      enabled=1
      gpgcheck=0
      
    6. Verify your yum configuration files.
      yum list httpd
      yum list apr
      
  2. Install Review Board.
    yum install teamforge
    
  3. Make sure that reviewboard, reviewboard-database and reviewboard-adapter identifiers have been added to the SERVICES token as required.

    server-01:SERVICES = ctfcore mail search codesearch cliserver etl subversion cvs gerrit binary binary-database reviewboard reviewboard-adapter
    server-02:SERVICES = ctfcore-database ctfcore-datamart gerrit-database reviewboard-database
    
  4. Do this on sites without internet access.
    1. Contact the CollabNet Support and get the python-modules-sources.zip file.
    2. Unzip the python-modules-sources.zip file to /opt/collabnet/teamforge/service/reviewboard/resources/SOURCES/python-modules-sources.
      unzip python-modules-sources.zip -d /opt/collabnet/teamforge/service/reviewboard/resources/SOURCES/python-modules-sources
      
  5. Provision services.
    teamforge provision
    

Provision the Database Server (server-02) with reviewboard-database Added to It

  1. If you have TeamForge installed, you should have the TeamForge installation repository configured already.

    For more information, see:

    TeamForge Installation Repository Configuration for Sites with Internet Access

    1. Contact the CollabNet Support and download the TeamForge 18.1 installation repository package to /tmp.
    2. Install the repository package.
      yum install -y /tmp/collabnet-teamforge-repo-18.1-0-noarch.rpm
      
    3. Refresh your repository cache.
      yum clean all
      

    TeamForge Installation Repository Configuration for Sites without Internet Access

    1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 18.1 disconnected installation and save it in /tmp.
      • RHEL/CentOS 7.4 64 bit: CTF-Disconnected-media-18.1.446-1261.rhel7.x86_64.rpm
      • In addition to the above CentOS 7.4 64 bit RPM package, you must get the following CentOS 7.4 compatibility RPM, which is required for TeamForge 18.1 disconnected media installation on CentOS 7.4 profile: compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm.
    2. Unpack the disconnected installation package.
      rpm -ivh <package-name>
      
    3. Unpack the compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm package if you are installing TeamForge 18.1 on CentOS 7.4.
      rpm -ivh compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
      
    4. If not mounted already, mount the RHEL/CentOS installation DVD.

      The DVD contains the necessary software and utilities required for installing TeamForge without internet access. In the following commands, replace “cdrom” with the identifier for your server’s CD/DVD drive, if necessary.

      cd /media/
      mkdir cdrom
      mount /dev/cdrom ./cdrom/
      

      If there are any spaces in the automount, unmount it first and mount it as a filepath, with no spaces.

    5. Create a yum configuration file that points to the RHEL/CentOS installation DVD.
      vi /etc/yum.repos.d/cdrom.repo
      

      Here’s a sample yum configuration file.

      [RHEL-CDROM]
      name=RHEL CDRom 			
      baseurl=file:///media/cdrom/Server/
      gpgfile=file:///media/cdrom/RPM-GPG-KEY-redhat-release 
      enabled=1
      gpgcheck=0
      
    6. Verify your yum configuration files.
      yum list httpd
      yum list apr
      
  2. Install Review Board.
    yum install teamforge
    
  3. Make sure that reviewboard, reviewboard-database and reviewboard-adapter identifiers have been added to the SERVICES token as required.

    server-01:SERVICES = ctfcore mail search codesearch cliserver etl subversion cvs gerrit binary binary-database reviewboard reviewboard-adapter cliserver
    server-02:SERVICES = ctfcore-database ctfcore-datamart gerrit-database reviewboard-database
    
  4. Provision services.
    teamforge provision
    

Do This Step by Step on the TeamForge Application Server (server-01)

  1. If SCM is installed on a separate box, run the following script to authenticate a scmviewer user against a TeamForge Subversion repository for creating a new review request.
    python ./svn-auth.py --repo-path=https://<scm_domain>/svn/repos/<repo_dir_name>
    

    You should now have a Review Board instance ready to work with TeamForge.


Install Review Board on a Separate Server

In this setup, you install TeamForge and Review Board on a two-server distributed setup with Review Board services running on a separate server.

Provision the TeamForge Application Server (server-01) with reviewboard-adapter Added to It

  1. If you have TeamForge installed, you should have the TeamForge installation repository configured already.

    For more information, see:

    TeamForge Installation Repository Configuration for Sites with Internet Access

    1. Contact the CollabNet Support and download the TeamForge 18.1 installation repository package to /tmp.
    2. Install the repository package.
      yum install -y /tmp/collabnet-teamforge-repo-18.1-0-noarch.rpm
      
    3. Refresh your repository cache.
      yum clean all
      

    TeamForge Installation Repository Configuration for Sites without Internet Access

    1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 18.1 disconnected installation and save it in /tmp.
      • RHEL/CentOS 7.4 64 bit: CTF-Disconnected-media-18.1.446-1261.rhel7.x86_64.rpm
      • In addition to the above CentOS 7.4 64 bit RPM package, you must get the following CentOS 7.4 compatibility RPM, which is required for TeamForge 18.1 disconnected media installation on CentOS 7.4 profile: compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm.
    2. Unpack the disconnected installation package.
      rpm -ivh <package-name>
      
    3. Unpack the compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm package if you are installing TeamForge 18.1 on CentOS 7.4.
      rpm -ivh compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
      
    4. If not mounted already, mount the RHEL/CentOS installation DVD.

      The DVD contains the necessary software and utilities required for installing TeamForge without internet access. In the following commands, replace “cdrom” with the identifier for your server’s CD/DVD drive, if necessary.

      cd /media/
      mkdir cdrom
      mount /dev/cdrom ./cdrom/
      

      If there are any spaces in the automount, unmount it first and mount it as a filepath, with no spaces.

    5. Create a yum configuration file that points to the RHEL/CentOS installation DVD.
      vi /etc/yum.repos.d/cdrom.repo
      

      Here’s a sample yum configuration file.

      [RHEL-CDROM]
      name=RHEL CDRom 			
      baseurl=file:///media/cdrom/Server/
      gpgfile=file:///media/cdrom/RPM-GPG-KEY-redhat-release 
      enabled=1
      gpgcheck=0
      
    6. Verify your yum configuration files.
      yum list httpd
      yum list apr
      
  2. Install Review Board.
    yum install teamforge
    
  3. Make sure that reviewboard, reviewboard-database and reviewboard-adapter identifiers have been added to the SERVICES token as required.

    server-01:SERVICES = ctfcore ctfcore-database ctfcore-datamart gerrit-database mail search codesearch cliserver etl subversion cvs gerrit binary binary-database reviewboard-adapter cliserver
    server-02:SERVICES = reviewboard reviewboard-database
    
  4. Provision services.
    teamforge provision
    

Install Review Board Services on the Review Board Server (server-02)

  1. If you have TeamForge installed, you should have the TeamForge installation repository configured already.

    For more information, see:

    TeamForge Installation Repository Configuration for Sites with Internet Access

    1. Contact the CollabNet Support and download the TeamForge 18.1 installation repository package to /tmp.
    2. Install the repository package.
      yum install -y /tmp/collabnet-teamforge-repo-18.1-0-noarch.rpm
      
    3. Refresh your repository cache.
      yum clean all
      

    TeamForge Installation Repository Configuration for Sites without Internet Access

    1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 18.1 disconnected installation and save it in /tmp.
      • RHEL/CentOS 7.4 64 bit: CTF-Disconnected-media-18.1.446-1261.rhel7.x86_64.rpm
      • In addition to the above CentOS 7.4 64 bit RPM package, you must get the following CentOS 7.4 compatibility RPM, which is required for TeamForge 18.1 disconnected media installation on CentOS 7.4 profile: compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm.
    2. Unpack the disconnected installation package.
      rpm -ivh <package-name>
      
    3. Unpack the compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm package if you are installing TeamForge 18.1 on CentOS 7.4.
      rpm -ivh compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
      
    4. If not mounted already, mount the RHEL/CentOS installation DVD.

      The DVD contains the necessary software and utilities required for installing TeamForge without internet access. In the following commands, replace “cdrom” with the identifier for your server’s CD/DVD drive, if necessary.

      cd /media/
      mkdir cdrom
      mount /dev/cdrom ./cdrom/
      

      If there are any spaces in the automount, unmount it first and mount it as a filepath, with no spaces.

    5. Create a yum configuration file that points to the RHEL/CentOS installation DVD.
      vi /etc/yum.repos.d/cdrom.repo
      

      Here’s a sample yum configuration file.

      [RHEL-CDROM]
      name=RHEL CDRom 			
      baseurl=file:///media/cdrom/Server/
      gpgfile=file:///media/cdrom/RPM-GPG-KEY-redhat-release 
      enabled=1
      gpgcheck=0
      
    6. Verify your yum configuration files.
      yum list httpd
      yum list apr
      
  2. Install Review Board.
    yum install teamforge
    
  3. Make sure that reviewboard, reviewboard-database and reviewboard-adapter identifiers have been added to the SERVICES token as required.

    server-01:SERVICES = ctfcore ctfcore-database ctfcore-datamart gerrit-database mail search codesearch cliserver etl subversion cvs gerrit binary binary-database reviewboard-adapter cliserver
    server-02:SERVICES = reviewboard reviewboard-database
    
  4. Do this on sites without internet access.
    1. Contact the CollabNet Support and get the python-modules-sources.zip file.
    2. Unzip the python-modules-sources.zip file to /opt/collabnet/teamforge/service/reviewboard/resources/SOURCES/python-modules-sources.
      unzip python-modules-sources.zip -d /opt/collabnet/teamforge/service/reviewboard/resources/SOURCES/python-modules-sources
      
  5. Provision services.
    teamforge provision
    
  6. Reinitialize TeamForge on the Review Board Server.
    teamforge reinitialize
    
  7. If SCM is installed on a separate box, run the following script to authenticate a scmviewer user against a TeamForge Subversion repository for creating a new review request.
    python ./svn-auth.py --repo-path=https://<scm_domain>/svn/repos/<repo_dir_name>
    

    You should now have a Review Board instance ready to work with TeamForge.


Post Install Tasks

Bootstrap Review Board Post Install or Upgrade

Use the following instructions if you want to bootstrap Review Board (drop Review Board database tables and recreate them again) for some reason post installation or upgrade.

  1. Log on to the server that hosts the Review Board.
  2. Select My Workspace > Admin.
  3. Select Projects > Integrated Apps.
  4. Select Review Board and click Delete.
  5. Stop TeamForge.
    teamforge stop
    
  6. Start the TeamForge database services.
    teamforge start -s postgres
    
  7. Bootstrap the Review Board database.
    teamforge bootstrap -s reviewboard-database-postgres
    
  8. Bootstrap the Review Board.
    teamforge bootstrap -s reviewboard
    
  9. Start TeamForge.
    teamforge start