Upgrade Review Board

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

Log on to the server as root user always

  1. Important:

    Do this on the main TeamForge Application Server if you are upgrading Review Board on the same hardware.

    As JDK is upgraded in TeamForge 16.3, you must run the install.py script to update the JDK version in /etc/reviewboard.properties file.

    Run the install.py script available in the Review Board installer directory.
    • cd /var/ops/RBInstaller-1.8.0.0.12
    • sudo 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.

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

  1. Important:

    Do this if you are upgrading Review Board on new hardware.

    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.
  2. Download the Review Board installer zip file from http://collab.net/downloads/integrations#tab-1 and save it in the /opt/collabnet folder
  3. Unzip the RBInstaller-1.8.0.0.12.zip file.
    • cd /opt/collabnet
    • unzip RBInstaller-1.8.0.0.12.zip
  4. 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.
  5. Start the TeamForge application.
    • /etc/init.d/collabnet start all
  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. Important:

    Do this if you are upgrading Review Board on new hardware.

    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-1.8.0.0.12
    • python ./install.py -i -r --auth-scmuser
  9. Run the migrate.py script available in the Review Board installer directory.
    • cd /opt/collabnet/RBInstaller-1.8.0.0.12
    • python ./migrate.py
  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>