Install Review Board

You must install the Review Board before you can make it available as an integrated application to project managers on your TeamForge site.

Important:
  • Install Review Board on the TeamForge Application Server and it needs PostgreSQL database.
  • To install Review Board successfully, ensure that other repositories similar to 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 16.10 supports Review Board 2.5.6.1 on RHEL/CentOS 6.8 and 7.2.
Attention: Installing or upgrading TeamForge needs root privileges. You must log on as root or use a root shell to install or upgrade TeamForge.

Do this on the main TeamForge Application Server. We'll call this my.app.box

  1. Download the Review Board installer zip file from http://collab.net/downloads/integrations#tab-1 and save it in the /opt/collabnet folder
    Note: Download the RBInstaller-16.10.4.zip file.
  2. Unzip the installer zip file.
    • cd /opt/collabnet
    • unzip RBInstaller-16.10.4.zip
  3. Modify these values in the install.conf file to suit your installation environment.
    • vi /opt/collabnet/RBInstaller-16.10.4/installer/install.conf
    Option Description
    rb_dir=/opt/collabnet/reviewboard The path of the directory where the Review Board files and libraries are installed.
    rb_data_dir=/opt/collabnet/reviewboard/data The path of the directory where Review Board's database file, review request files and attachments are stored.
    Note: It's recommended to change the default value of rb_data_dir with /opt/collabnet/teamforge/var/reviewboard/data.
    domain=<domain name or host name> The Review Board site information. For example, cu064.cloud.maa.collab.net.
    rb_database_password=<reviewboard_db_password> The Review Board database password.
    rb_database_type=postgresql The Review Board database type.
    rb_database_name=<reviewboard_db_name> The Review Board database name.
    rb_database_user=<reviewboard_username> The Review Board database user name.
    rb_database_host=<reviewboard_db_hostname> The Review Board database host name.
    rb_database_port=<reviewboard_db_port> The Review Board database port.
    ctf_base_url=https://myapp.collab.net The absolute URL of the TeamForge site that you want to associate to.
    ctf_site_var_dir=/opt/collabnet/teamforge/var The location of the rbctfevents.jar file.
  4. Start TeamForge.
    • /opt/collabnet/teamforge/bin/teamforge start
  5. Run the following grep commands to get the value of HTTPD_USER, HTTPD_GROUP and HOME_DIR_BASE.
    • grep HTTPD_USER= /opt/collabnet/teamforge/runtime/conf/runtime-options.conf
    • grep HTTPD_GROUP= /opt/collabnet/teamforge/runtime/conf/runtime-options.conf
    • grep HOME_DIR_BASE= /opt/collabnet/teamforge/runtime/conf/runtime-options.conf
    • chown -R <HTTPD_USER>:<HTTPD_GROUP> <HOME_DIR_BASE>/<HTTPD_USER>
  6. Run the install.py script available in the Review Board installer directory.
    • cd /opt/collabnet/RBInstaller-16.10.4
    • python ./install.py -i -r --auth-scmuser
    Attention: The Review Board installer pauses abruptly on sites using trusted certificates expecting user intervention. Press Enter to proceed with the installation/upgrade.
  7. Perform this step on the TeamForge PostgreSQL Database Server on sites with database running on a separate server.
    1. Create the Review Board database and user name.
      • su - postgres
      • createuser -P -S --createdb --no-createrole ctfrbuser
      • createdb -E UTF8 -O ctfrbuser ctfrbdb
      • exit
  8. Set up the initial Review Board data. Run the bootstrap-data.py script available in the Review Board installer directory.
    • cd /opt/collabnet/RBInstaller-16.10.4
    • python ./bootstrap-data.py
  9. Run the grep command to get the value of httpd_user and httpd_group.
    • grep httpd_user /etc/reviewboard.properties
    • grep httpd_group /etc/reviewboard.properties
    • chown -R <httpd_user>:<httpd_group> /opt/collabnet/reviewboard/data
  10. Restart TeamForge.
    • /opt/collabnet/teamforge/bin/teamforge restart
  11. 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. The installer has created two configuration files: installer/conf/rb-application.xml and installer/conf/rb-deploy.xml. See Integrate Review Board with your TeamForge site for more information.
Note: Run the following scripts available in the Review Board installer directory.