Upgrade Review Board

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

TeamForge 17.11 supports Review Board 2.5.6.1 on RHEL/CentOS 6.9 and 7.4.
This procedure is for those who have Review Board already and are upgrading Review Board to a latest build on RHEL/CentOS 6.9 or 7.4.
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.

Attention: Installing or upgrading TeamForge needs root privileges. You must log on as root or use a root shell to install or upgrade TeamForge.

Do this step by step on the TeamForge Application Server

Upgrade from TeamForge 17.1 or earlier to TeamForge 17.4 or later: The default Review Board data directory has been changed from /opt/collabnet/reaviewboard/data to /opt/collabnet/teamforge/var/reviewboard/data in TeamForge 17.4. If you are upgrading from TeamForge 17.1 or earlier to TeamForge 17.4 or later, regardless of whether you upgrade Review Board on the same or new hardware, you must back up your Review Board data directory from /opt/collabnet/reaviewboard/data and restore it to /opt/collabnet/teamforge/var/reviewboard/data.
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.
  - 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 if you are upgrading Review Board on a new hardware.
If you are upgrading from TeamForge 17.4 to TeamForge 17.8 (or later) on a new hardware:
- cd /opt/collabnet/teamforge/var
- tar -zcvf /tmp/reviewboard_data.tgz reviewboard
Tip: If you are upgrading from TeamForge 17.4 (or later), the /opt/collabnet/teamforge/var directory would have been backed up already as part of your TeamForge upgrade process, in which case you can skip backing up the /opt/collabnet/teamforge/var directory again.

Copy the /tmp/reviewboard_data.tgz file to the /tmp directory of the new server.
Make sure that "reviewboard" , "reviewboard-database" and "reviewboard-adapter" identifiers have been added to the host:SERVICES token of the TeamForge Application Server.
```
server-01:SERVICES=ctfcore ctfcore-database mail search codesearch  etl ctfcore-datamart subversion cvs 
gerrit gerrit-database binary binary-database reviewboard reviewboard-database reviewboard-adapter cliserver 
```
Configure your TeamForge installation repository. If you have TeamForge installed, you would have the installation repository already configured.
- TeamForge installation repository configuration for sites with internet access
1. Contact the CollabNet Support and download the TeamForge 17.11 installation repository package to /tmp.
2. Install the repository package.
  - yum install -y /tmp/collabnet-teamforge-repo-17.11-0.noarch.rpm
3. Refresh your repository cache.
  - yum clean all
- TeamForge installation repository configuration for sites without internet access
1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 17.11 disconnected installation and save it in /tmp.
  - Red Hat Enterprise Linux/CentOS 7.4 64 bit RPM package: CTF-Disconnected-media-17.11.501-841.rhel7.x86_64.rpm
    Note: In addition to the above CentOS 7.4 64 bit RPM package, you must get the following CentOS 7.4 compatibility RPM, which is required for TeamForge 17.11 disconnected media installation on CentOS 7.4 profile: compat-ctf-dc-media-1.1-1.el7.noarch.rpm.
2. Unpack the disconnected installation package.
  - rpm -ivh <package-name>
3. Unpack the compat-ctf-dc-media-1.1-1.el7.noarch.rpm package if you are installing TeamForge 17.11 on CentOS 7.4.
  - rpm -ivh compat-ctf-dc-media-1.1-1.el7.noarch.rpm
4. Note: If the Red Hat Enterprise Linux/CentOS installation DVD is mounted already, skip the following instructions. If not, mount the DVD.
  Mount the Red Hat Enterprise Linux/CentOS installation DVD. The DVD contains the necessary software and utilities required for installing TeamForge without internet access.
  In the following commands, replace "cdrom" with the identifier for your server's CD/DVD drive, if necessary.
  - cd /media/
  - mkdir cdrom
  - mount /dev/cdrom ./cdrom/
  If there are any spaces in the automount, unmount it first and mount it as a filepath, with no spaces.
5. Create a yum configuration file that points to the Red Hat Enterprise Linux/CentOS installation DVD.
  - vi /etc/yum.repos.d/cdrom.repo
  Here's a sample yum configuration file.
```
[RHEL-CDROM] 
name=RHEL CDRom 			
baseurl=file:///media/cdrom/Server/
gpgfile=file:///media/cdrom/RPM-GPG-KEY-redhat-release 
enabled=1
gpgcheck=0
```
6. Verify your yum configuration files.
  - yum list httpd
  - yum list apr
Upgrade Review Board:
- yum install CN-reviewboard
Provision services.
- teamforge provision
Note:
TeamForge 17.4 (and later) installer expects the system locale to be LANG=en_US.UTF-8. TeamForge "provision" command fails otherwise.
Restore the Review Board data.
Note:
- The default Review Board data directory has been changed from /opt/collabnet/reaviewboard/data to /opt/collabnet/teamforge/var/reviewboard/data in TeamForge 17.4. If you are upgrading from TeamForge 17.1 or earlier to TeamForge 17.4 or later, regardless of whether you upgrade Review Board on the same or new hardware, you must back up your Review Board data directory from /opt/collabnet/reaviewboard/data and restore it to /opt/collabnet/teamforge/var/reviewboard/data.
- If you are upgrading from TeamForge 17.4 (or later), the /opt/collabnet/teamforge/var directory would have been restored already as part of your TeamForge upgrade process, in which case you can skip restoring the /opt/collabnet/teamforge/var directory again.
- If you are upgrading on a new hardware, 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/teamforge/var/
  - tar -zxvf /tmp/reviewboard_data.tgz
Run the install.py script available in the Review Board installer directory.
- cd /opt/collabnet/RBInstaller-17.11
- python ./install.py -i -r --auth-scmuser
Run the migrate.py script available in the Review Board installer directory.
- cd /opt/collabnet/RBInstaller-17.11
- python ./migrate.py
Restart TeamForge.
- teamforge restart
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>