The rb-site Tool¶

Overview¶

Most of the work of installing and managing a Review Board site is done for you by a tool bundled with Review Board called rb-site.

rb-site has three main commands:

install
upgrade
manage

These will be discussed in detail in the following sections.

rb-site always requires a command as the first argument and a site directory as the second. Some commands may accept additional arguments.

Global Options¶

–version¶: Shows the version number and exits.

-h, –help¶: Shows the help for the program and exits.

–console¶: Forces use of the console UI for any interaction.

-d, –debug¶: Displays debug output in the console.

rb-site install¶

Installs a new Review Board site. This will ask a series of questions and will populate a tree for the website, as well as generate configuration files.

If rb-site is run in an X11 environment with GTK+, then this will present a graphical wizard for the questions. Otherwise, this will ask in the console.

This takes a directory as the first parameter. For example:

$ rb-site install /path/to/site

See Creating a Review Board Site for more information.

Options¶

–copy-media¶: Copies media files to the site directory. By default, media files and directories are symlinked. This option is implied on Windows.

–noinput¶: Runs non-interactively, using configuration provided through command line options.

–domain-name=<DOMAIN_NAME>¶: The full domain name of the site, excluding the http:// port or path. For example, reviews.example.com

–site-root=<SITE_ROOT>¶: The path of the site, relative to the domain. This should end with a trailing /. For example, / or /reviews/.

–media-url=<MEDIA_URL>¶: The URL containing the media files. This should end with a trailing /. For example, /media/ or http://media.example.com/.

–db-type=<DB_TYPE>¶

The database type. This should be one of:

mysql
postgresql
sqlite3

–db-name=<DB_NAME>¶: The database name (database file path for sqlite3).

–db-user=<DB_USER>¶: The username used for connecting to the database (not used for sqlite3).

–db-pass=<DB_PASS>¶: The password used for connecting to the database (not used for sqlite3).

–cache-type=<CACHE_TYPE>¶

The cache server type. This should be one of:

memcached
file

–cache-info=<CACHE_INFO>¶

The detailed cache information. This is dependent on the cache type used.

For memcached, this should be a connection string (such as memcached://localhost:11211/.

For file, this should be the path to a cache directory that the web server can write to.

–web-server-type=<WEB_SERVER_TYPE>¶

The type of web server that will run the site. This should be one of:

apache
lighttpd

–python-loader=<PYTHON_LOADER>¶

The type of Python loader. This should be one of:

modpython
fastcgi

For lighttpd, the only choice is fastcgi.

–admin-user=<ADMIN_USER>¶: The username for the new site administrator account.

–admin-password=<ADMIN_PASSWORD>¶: The password for the new site administrator account.

–admin-email=<ADMIN_EMAIL>¶: The e-mail address for the new site administrator account.

rb-site upgrade¶

Upgrades an existing site installation. This will update the media trees and upgrade the database.

This must be performed every time Review Board is upgraded.

This takes a directory as the first parameter. For example:

$ rb-site upgrade /path/to/site

See Upgrading Sites for more information.

Options¶

–no-db-upgrade¶: Prevents an upgrade and evolution of the database.

rb-site manage¶

Performs management commands on a site.

This is an advanced command that wraps the Django manage.py command. It takes a path to the site, a manage subcommand, and optional parameters (following a --).

For example:

$ rb-site manage /path/to/site shell
$ rb-site manage /path/to/site index -- --full

You can see the list of manage subcommands by running:

$ rb-site manage /path/to/site help

For more information, and some useful subcommands, see Advanced Management Commands.