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. Uninstall the existing Review Board application if you are upgrading on the same server.
   • cd /opt/collabnet/RBInstaller-1.7.0.0.7
   • python ./install.py -u
3. Back up your Review Board data directory if you are upgrading TeamForge and Review Board on a new server. 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.
      • 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.
4. Unzip the RBInstaller-1.8.0.0.12.zip file.
   • cd /opt/collabnet
   • unzip RBInstaller-1.8.0.0.12.zip
5. Modify these values in the install.conf file to suit your installation environment.
   • vi /opt/collabnet/RBInstaller-1.8.0.0.12/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.

6. Start the TeamForge application.
   • /etc/init.d/collabnet start all
7. 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>
8. 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
9. Run the install.py script available in the Review Board installer directory.
   • cd /opt/collabnet/RBInstaller-1.8.0.0.12
   • python ./install.py -i -r --auth-scmuser
10. Run the migrate.py script available in the Review Board installer directory.
    • cd /opt/collabnet/RBInstaller-1.8.0.0.12
    • python ./migrate.py
11. Restart the TeamForge application.
    • /etc/init.d/collabnet stop all
    • /etc/init.d/collabnet start all
12. 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>