Upgrade Review Board

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

Review Board: Review Board 2.0.11 is not compatible with SUSE Linux Enterprise Server 11 SP2. You must continue to use Review Board 1.7.17 if you are upgrading from TeamForge 7.2 (or earlier) to 8.0 or later on SUSE Linux Enterprise Server 11 SP2. In other words, you do not have to upgrade Review Board if you are upgrading from TeamForge 7.2 to 8.0 or later on SUSE Linux Enterprise Server 11 SP2.
Important: However, as JDK is upgraded in TeamForge 8.0 and later, you must run the install.py script to update the JDK version in /etc/reviewboard.properties file. Refer to the following steps.
1. Run the grep command to get the encrypted password.
  - grep SCM_USER_ENCRYPTED_PASSWORD /opt/collabnet/teamforge/runtime/conf/runtime-options.conf
2. Use the password_util.sh script to decrypt the scmviewer password.
  - /opt/collabnet/teamforge/runtime/scripts/password_util.sh -decrypt '<value of SCM_USER_ENCRYPTED_PASSWORD>'
3. Run the install.py script available in the Review Board installer directory.
  - cd /var/ops/RBInstaller-1.5.0.0.5
  - python ./install.py -i -r --auth-scmuser
See Upgrade to Review Board 1.7.17 if you want to upgrade from older versions of Review Board to Review Board 1.7.17.
This procedure is for those who have Review Board already and are upgrading Review Board to a latest build on RHEL/CentOS 7.0.
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.
TeamForge 8.0 supports Review Board 2.0.11 and 1.7.17 on RHEL/CentOS 7.0 and SUSE Linux Enterprise Server 11 SP2 respectively.

Log on to the server as root user always

Do this on the main TeamForge application server. We'll call this my.app.box.

Create a /var/ops/ folder, download the RBInstaller-1.6.0.0.11.zip file from http://collab.net/downloads/integrations#tab-1 and save it in the /var/ops/ folder.
Uninstall the existing Review Board application if you are upgrading on the same server.
- cd /var/ops/RBInstaller-1.5.0.0.5
- python ./install.py -u
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.
Unzip the RBInstaller-1.6.0.0.11.zip file.
- cd /var/ops/
- unzip RBInstaller-1.6.0.0.11.zip

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

vi /var/ops/RBInstaller-1.6.0.0.11/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_password=<reviewboard_db_password>	The Review Board database password.
rb_database_type=postgresql	The Review Board database type.
rb_database_name=<reviewboard_db_name>	The database name of the Review Board.
rb_database_user=<reviewboard_username>	The Review Board database user name.
rb_database_host=<reviewboard_db_hostname>	The Review Board database host name. Tip: This is typically the application server's host name as Review Board always runs on the TeamForge application server. Default value is 'localhost'.
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.

Start the TeamForge application.
- /etc/init.d/collabnet start all
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 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
Run the install.py script available in the Review Board installer directory.
- cd /var/ops/RBInstaller-1.6.0.0.11
- python ./install.py -i -r --auth-scmuser
Do this only if you have TeamForge Orchestrate Review Board adapter installed.
1. Upgrade pip if you do not have the minimum required version.
  - pip install --upgrade pip
2. Upgrade setuptools if you do not have the minimum required version.
  - pip install --upgrade setuptools
3. Install the orchestrate-rb-1.2 adapter.
  - pip install --use-wheel --no-index --find-links=http://orchestrate.collab.net/RHEL/6/x86_64/wheelhouse orchestrate_rb==1.2
Run the migrate.py script available in the Review Board installer directory.
- cd /var/ops/RBInstaller-1.6.0.0.11
- python ./migrate.py
Restart the TeamForge application.
- /etc/init.d/collabnet stop all
- /etc/init.d/collabnet start all
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>