Installing and Configuring r3

Use the instructions below for installation:

Download the two packages that make up the complete application:
- Stickleback—The plugin engine which powers r3's command line interface. Download Stickleback from http://sourceforge.net/projects/stickleback.
- r3—Download r3 from http://sourceforge.net/projects/rthree.

Install Stickleback and r3 (use version numbers shown here, or higher):

$ sudo sudo pear install -f stickleback-0_9_1.tgz 
install ok: channel://pear.php.net/stickleback-0.9.1
$ sudo pear install -f --alldeps r3-0_9_1.tgz 
install ok: channel://pear.php.net/r3-0.9.1

Create an r3 working directory:
```
$ mkdir ~/r3
```
Have r3 prepare the directory for you.
```
$ r3 setup setuphome ~/r3
```
Create an environment variable to remind r3 where its home is. For convenience you could put this in a startup or login script.
```
$ export R3HOME=~/r3
```
Set up your databases:
1. To use r3 against MySQL, edit $R3HOME/r3.conf.xml and change the<DB> section to refer to mysql with the appropriate host, dbname etc.
  
  Note
  
  If you are setting up the MySQL database yourself, ensure that you have correct permissions, etc, and that a MySQL server is running.
2. For either MySQL or SQLite, create local databases using the $R3HOME environment variable.
```
$ r3 setup installdb
```

	Note
	If you are setting up the MySQL database yourself, ensure that you have correct permissions, etc, and that a MySQL server is running.

r3 User Guide

Installing and Configuring r3