Installing JamBox on a Raspberry Pi =================================== 1.) On your Raspberry Pi, run (instructions were tested on a Raspberry Pi 2 running Raspbian Jessie): `sudo apt-get update` `sudo apt-get install -y build-essential` `sudo apt-get install -y libapache2-mod-php5` `sudo apt-get install -y php5-dev` 2.) Get the Perforce client, server, C++ API, PHP API: `wget ftp://ftp.perforce.com/perforce/r15.2/bin.linux26armhf/p4` `wget ftp://ftp.perforce.com/perforce/r15.2/bin.linux26armhf/p4d` `wget ftp://ftp.perforce.com/perforce/r15.2/bin.linux26armhf/p4api.tgz` `wget -O p4php.zip https://swarm.workshop.perforce.com/projects/perforce-software-p4php/archives/main.zip` 3.) Change permissions on p4 and p4d and move files to bin directory: `chmod +x p4` `chmod +x p4d` `sudo mv p4 /usr/local/bin` `sudo mv p4d /usr/local/bin` 4.) Start p4d, create 'guest' and '.swarm' depot: `mkdir /home/pi/p4root` `p4d -r /home/pi/p4root -p 0.0.0.0:1666 -d` `p4 -p localhost:1666 depot guest` `p4 -p localhost:1666 depot .swarm` 5.) Set configurables to enable [DVCS](https://www.perforce.com/blog/150402/now-available-helix-versioning-engine-dvcs-capabilities) functionality: `p4 configure set server.allowfetch=2` `p4 configure set server.allowpush=2` 6.) Build P4PHP: `tar zxvf p4api.tgz` `unzip p4php.zip` `mv main p4php` `cd p4php` `phpize` `./configure --with-perforce=../p4api-2015.2.1326881 (your version might be different)` `make` `make test` `sudo make install` **NOTE**: In the summary, you should see something like: Libraries have been installed in: /home/pi/p4php/modules 7.) Add this line to your php.ini file: extensions=/home/pi/p4php/modules/perforce.so **NOTE**: If you've been following the directions, php.ini file should be located here: /etc/php5/apache2/php.ini 8.) Download JamBox code and setup: `p4 -d jambox -u guest clone -p workshop.perforce.com:1666 -f //guest/thomas_gray/jambox/main/...` `cd jambox/swarm` `sudo chown www-data data` 9.) Add this config.php file to $JAMBOX_HOME/data: > return array( > 'p4' => array( > 'port' => 'localhost:1666', > 'user' => 'swarm', > 'password' => 'password', > ), > 'p4_super' => array( > 'port' => 'localhost:1666', > 'user' => 'perforce', > 'password' => 'password', > ), > 'security' => array( > 'require_login' => false, > 'disable_autojoin' => true, > ), > 'notifications' => array( > 'honor_p4_reviews' => true, > ), > 'queue' => array( > 'workers' => 3, // defaults to 3 > 'worker_lifetime' => 595, // defaults to 10 minutes (less 5 seconds) > 'worker_task_timeout' => 1800, // defaults 30 minutes > 'worker_memory_limit' => '1G', // defaults to 1 gigabyte > ), > 'reviews' => array( > 'disable_commit' => false, > ), > ); **NOTE: Make sure you have created a 'swarm' and 'perforce' user with super permissions (p4 user -f username)** 10.) Setup Swarm Triggers: `/home/pi/jambox/swarm/p4-bin/scripts/swarm-triggers.sh -o > swarm-triggers.txt` `p4 -p localhost:1666 triggers -o > default-triggers.txt` `cat default-triggers.txt swarm-triggers.txt > final.txt` `p4 -p localhost:1666 triggers -i < final.txt` 11.) In the /etc/apache2/sites-available directory, edit the file '000-default.conf' with following contents: > > ServerName localhost > ErrorLog "/var/log/apache2/swarm_error.log" > CustomLog "/var/log/apache2/swarm_access.log" common > DocumentRoot "/home/pi/jambox/swarm/public" > > AllowOverride All > Require all granted > > 12.) Restart Apache `sudo apachectl restart` Let's try logging into your Swarm instance: Open up a browser and enter 127.0.0.1:80 (or ip address if accessing from another machine) Log into using username: pi (leave password blank) Now that's you've successfully logged in, there are few more things we need to do. 13.) Setup the Trigger Token: * Click on 'pi' userid (upper right corner) | About Swarm * Copy Trigger Token * Open up the file: /home/pi/jambox/swarm/p4-bin/scripts/swarm-triggers.sh * Fill in the values for SWARM_HOST and SWARM_TOKEN: SWARM_HOST="http://ip_address/" SWARM_TOKEN="Trigger Token you just copied" 14.) Add Workers: `crontab -e` Add the following line and exit: `* * * * * wget -q -O /dev/null -T5 http://IP_ADDRESS/queue/worker`