Upgrade Review Board

Use these instructions to upgrade Review Board to a latest build.

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
   
2. New hardware upgrade: Back up your Review Board data directory if you are upgrading TeamForge and Review Board on a new server.
   Tip: The Review Board database is backed up already when you have upgraded TeamForge. So, it is not necessary to take a back up of the Review Board database again.
   1. Back up the Review Board data directory. It is assumed that /opt/collabnet/reviewboard/data is the Review Board data directory.
      • cd /opt/collabnet
      • tar -zcvf /tmp/reviewboard_data.tgz reviewboard
   2. Copy the /tmp/reviewboard_data.tgz file to the /tmp directory of the new server.
3. Unzip the RBInstaller-16.10.4.zip file.
   • cd /opt/collabnet
   • unzip RBInstaller-16.10.4.zip
4. 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_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.

5. Start TeamForge.
   • /opt/collabnet/teamforge/bin/teamforge start
6. 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
   • sudo chown -R <HTTPD_USER>:<HTTPD_GROUP> <HOME_DIR_BASE>/<HTTPD_USER>
7. New hardware upgrade: Restore the Review Board data if you are upgrading TeamForge and Review Board on a new server.
   Note: Ensure that you have already copied the backup of the Review Board data directory to the /tmp directory of the new server.
   1. Restore the Review Board data directory.
      • cd /opt/collabnet
      • tar -zxvf /tmp/reviewboard_data.tgz
8. 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
9. Run the migrate.py script available in the Review Board installer directory.
   • cd /opt/collabnet/RBInstaller-16.10.4
   • python ./migrate.py
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>
12. Select My Workspace > Admin and select Projects > System Tools > Customizations.
13. Select rbctfevents.jar and click Enable.