Skip to main content
Version: TeamForge 23.0

Upgrade Review Board

Before You Begin
  • TeamForge 23.0 supports Review Board 4.0.6 on RHEL 8.6 and Review Board 4.0.6 on RHEL/CentOS 7.9.
  • This procedure is for those who have Review Board already and are upgrading Review Board to a latest build on RHEL/CentOS 7.9 or RHEL 8.6.
  • You may choose to upgrade Review Board on the same server or on a new server.
  • In this scenario, both TeamForge and Review Board use PostgreSQL.
  • To install Review Board successfully, ensure that other repositories such as EPEL (Extra Packages for Enterprise Linux) are disabled apart from the CollabNet and Operating System repositories.
  • Upgrading Review Board needs root privileges. You must log on as root or use a root shell to upgrade Review Board.

Back up and Restore the Review Board Database and Data Directories​

If Review Board and TeamForge are co-hosted on the same server, the Review Board database and data directories should have been backed up already when you backed up TeamForge. So, it is not necessary to take a back up of the Review Board database and data directories again. However, you must back up Review Board if you have Review Board on a separate server outside of the TeamForge Application Server.

  1. Back up the /opt/collabnet/teamforge/var/pgsql and /opt/collabnet/teamforge/var/reviewboard/data directories from the Review Board Server that hosts the Review Board database service (reviewboard-database) in case you have Review Board on a separate server outside of the TeamForge Application Server.

    mkdir -p /tmp/backup_dir
    cd /opt/collabnet/teamforge/var
    tar -zcvf /tmp/backup_dir/reviewboard_pgsql.tgz pgsql/11.12
    tar -zcvf /tmp/reviewboard_data.tgz reviewboard

  2. Copy the /tmp/reviewboard_pgsql.tgz and reviewboard_data.tgz files to the /tmp directory of the new server if you are upgrading Review Board on a new hardware.

    scp /tmp/reviewboard_pgsql.tgz username@newRBbox:/tmp
    scp /tmp/reviewboard_data.tgz username@newRBbox:/tmp

Upgrade Review Board​

note

TeamForge 18.1 and later has no support for having service-specific FQDN for Review Board.

  1. Make sure that reviewboard, reviewboard-database and reviewboard-adapter identifiers have been added to the SERVICES token of the TeamForge Application Server (server-01).

    server-01:SERVICES=ctfcore ctfcore-database mail search codesearch etl ctfcore-datamart subversion gerrit gerrit-database binary binary-database reviewboard reviewboard-database reviewboard-adapter cliserver

    It is assumed that the Review Board is running on the TeamForge Application Server. In case you have a separate Review Board Server, add the reviewboard and reviewboard-database identifiers to the Review Board server's SERVICES token.

  2. tip

    If you have TeamForge installed, you would have the installation repository already configured.

  3. Upgrade Review Board.

    yum install teamforge

  4. Restore the Review Board database and data directories (on the new server where you plan to have the Review Board database).

    cd /opt/collabnet/teamforge/var/
    tar -zxvf /tmp/reviewboard_pgsql.tgz
    tar -zxvf /tmp/reviewboard_data.tgz

  1. Provision services.

    teamforge provision

  2. 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>

Post Upgrade Tasks​

  • [Add Review Board to Projects][iaf-reviewboard-add]

Bootstrap Review Board Post Install or Upgrade​

Use the following instructions if you want to bootstrap Review Board (drop Review Board database tables and recreate them again) for some reason post installation or upgrade.

  1. Log on to the server that hosts the Review Board.
  2. Select My Workspace > Admin.
  3. Select Projects > Integrated Apps.
  4. Select Review Board and click Delete.
  5. Stop TeamForge. 
    teamforge stop
  6. Start the TeamForge database services. 
    teamforge start -s postgres
  7. Bootstrap the Review Board database. 
    teamforge bootstrap -s reviewboard-database-postgres
  8. Bootstrap the Review Board. 
    teamforge bootstrap -s reviewboard

  9. Start TeamForge.

    teamforge start