Upgrade Review Board

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

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

1. Download the Review Board installer zip file from http://collab.net/downloads/integrations#tab-1 and save it in the /opt/collabnet folder
   
2. New hardware upgrade: Back up your Review Board data directory if you are upgrading TeamForge and Review Board on a new server.
   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.
3. Make sure that "reviewboard" and "reviewboard-database" identifiers have been added to the SERVICES token of the TeamForge Application Server's site-options.conf file.

   my.app.host:SERVICES = ctfcore ctfcore-database mail search codesearch etl ctfcore-datamart subversion cvs 
   gerrit gerrit-database binary binary-database reviewboard reviewboard-database

   Review Board database can be installed on TeamForge PostgreSQL Database Server on sites with database running on a separate server, in which case you must add the "reviewboard-database" identifier to the SERVICES token of the TeamForge PostgreSQL Database Server's site-options.conf file.

4. Unzip the RBInstaller-17.1.5.zip file.
   • cd /opt/collabnet
   • unzip RBInstaller-17.1.5.zip
5. Modify these values in the install.conf file to suit your installation environment.
   • vi /opt/collabnet/RBInstaller-17.1.5/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/teamforge/var/reviewboard/data	The path of the directory where Review Board's database file, review request files and attachments are stored. Note: It's recommended to change the default value of rb_data_dir with /opt/collabnet/teamforge/var/reviewboard/data.
   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.

6. Deploy services.
   • /opt/collabnet/teamforge/bin/teamforge provision

   The "provision" command prompts for response before it bootstraps or migrates data during TeamForge installation and upgrade respectively. Enter "Yes" or "No" to proceed. For more information, see The teamforge script.

7. 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>
8. New hardware upgrade:: 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.
   • It's assumed that /opt/collabnet/teamforge/var/reviewboard/data is the Review Board data directory.
   1. Restore the Review Board data directory.
      • cd /opt/collabnet/teamforge/var
      • tar -zxvf /tmp/reviewboard_data.tgz
9. Run the install.py script available in the Review Board installer directory.
   • cd /opt/collabnet/RBInstaller-17.1.5
   • python ./install.py -i -r --auth-scmuser
10. Run the migrate.py script available in the Review Board installer directory.
    • cd /opt/collabnet/RBInstaller-17.1.5
    • python ./migrate.py
11. Restart TeamForge.
    • setenforce 1
    • /opt/collabnet/teamforge/bin/teamforge restart
12. 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>
13. Select My Workspace > Admin and select Projects > System Tools > Customizations.
14. Select rbctfevents.jar and click Enable.