Installation¶

Requirements¶

Power Pack 2.x supports Review Board 2.0 and newer. Power Pack 1.x supports Review Board 1.7 and newer.

The PDF Review feature requires users to have a modern web browser (Mozilla Firefox 10+, Google Chrome, or Internet Explorer 10+).

Installing and enabling the extension¶

To install Power Pack, run the following:

$ sudo easy_install ReviewBoardPowerPack

Depending on your configuration, you may need to restart or reload your web server. The specific command depends on your individual setup, but is usually something like the following:

$ sudo /etc/init.d/httpd reload

Now open the Review Board administration page, and click Extensions in the top bar. You should see a new extension called “Review Board Power Pack”. Click Enable to enable it.

Getting and installing a license¶

Power Pack 1.3.5 and higher can be used without a license by up to 2 people, for most features. This is a great way to try out Power Pack’s features, and is perfect if you only have a couple people who need to work with features like Reports or PDF Document Review.

You can optionally install a trial license, providing all Power Pack features to all your users for 30 days.

In order to use Power Pack, you’ll need to install a license file. If you’ve purchased a Power Pack subscription, this license file will have been provided to you. If you’re trying out Power Pack prior to purchasing a subscription, you’ll need to request a trial key.

Installing a trial license¶

A trial license allows all the users on your server to use all of Review Board’s features for up to 30 days. After 30 days, the license will revert to the limited 2 user license.

To install a trial license, start by clicking Configure under the Power Pack entry on the extensions administration page. Then click Try it free for 30 days.

This will take you to a form, which will be partially filled out. Fill out the rest and then save the form. It will automatically download and install your new trial license for you.

Once the trial has expired, you have the option of keeping the trial license

Installing a purchased license¶

If you’ve purchased a license, you’ll have been sent a file that you can install.

First, click Configure under the Power Pack entry on the extensions administration page. On this page, you’ll see a browse button for uploading your license file (refer to the screenshot above). Once you’ve chosen the license, save the settings.

If all went correctly, you should see the license information at the top of the page.

Add users to your license¶

Now that Power Pack is configured and licensed, you’ll need to add users to your install (unless you’re running a trial license, in which case all users will be effectively added until the trial expires).

To add licensed users, click Manage users on the Configure Power Pack page (see the screenshot above). From here, you can add individual users to the license, import batches of users into your license, or enable automatic user licensing.

Upgrading to a new version of Power Pack¶

To upgrade Power Pack, run:

$ sudo easy_install -U ReviewBoardPowerPack

Depending on your configuration, you may need to restart or reload your web server. The specific command depends on your individual setup, but is usually something like the following:

$ sudo /etc/init.d/httpd reload

If you’re running Review Board 2.0.0 or newer, you’re done. If you’re running Review Board 1.7.x or one of the 2.0 pre-releases, you’ll also need to go to the extensions admin page and disable the extension, then re-enable it.