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.

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-1.9.3.zip file.
2. Unzip the installer zip file.
   • cd /opt/collabnet
   • unzip RBInstaller-1.9.3.zip
3. Modify these values in the install.conf file to suit your installation environment.
   • vi /opt/collabnet/RBInstaller-1.9.3/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.
   domain=<domain name or host name>	The Review Board site information. For example, cu064.cloud.maa.collab.net.
   rb_database_type=postgresql	The Review Board database type.
   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 the TeamForge application.
   • /etc/init.d/collabnet start all
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-1.9.3
   • 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-1.9.3
   • 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 the TeamForge application.
    • /etc/init.d/collabnet stop all
    • /etc/init.d/collabnet start all
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.