Upgrade Review Board

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

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

Download the Review Board installer zip file from http://collab.net/downloads/integrations#tab-1 and save it in the /opt/collabnet folder
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.
Make sure that "reviewboard" , "reviewboard-database" and "reviewboard-adapter" identifiers have been added to the host:SERVICES token of the TeamForge Application Server's site-options.conf file.
```
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 
```
Unzip the RBInstaller-17.4.7.zip file.
- cd /opt/collabnet
- unzip RBInstaller-17.4.7.zip

Modify these values in the install.conf file to suit your installation environment.

vi /opt/collabnet/RBInstaller-17.4.7/installer/install.conf

Option	Description
rb_dir=/opt/collabnet/teamforge/var/reviewboard	The path of the directory where the Review Board files and libraries are installed.
rb_data_dir=/opt/collabnet/teamforge/var/reviewboard/data	The path of the directory where Review Board's database file, review request files and attachments are stored. 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.
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.

Deploy services.
- /opt/collabnet/teamforge/bin/teamforge provision
Note:
The "provision" command prompts for response before it bootstraps or migrates data during TeamForge installation and upgrade respectively. Enter "y" or "N" to proceed. For more information, see the TeamForge script.

TeamForge 17.4 (and later) installer expects the system locale to be LANG=en_US.UTF-8. TeamForge "provision" command fails otherwise.
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>
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.

Note: 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.4.7
- python ./install.py -i -r --auth-scmuser
Run the migrate.py script available in the Review Board installer directory.
- cd /opt/collabnet/RBInstaller-17.4.7
- python ./migrate.py
Restart TeamForge.
- setenforce 1
- /opt/collabnet/teamforge/bin/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>
Select My Workspace > Admin and select Projects > System Tools > Customizations.
Select rbctfevents.jar and click Enable.