Installation and Setup

Installation/Setup

Stopping Version 1

IMPORTANT: Follow ALL of these steps IN ORDER!

This step only applies if you are running Version 1. If you are not running Version 1. just skip this and go to installing Version 2.

ps xaf | egrep "JackrabbitRelay|Equilibrium|Procurator"

You should see something like the below image.

Jackrabbit Relay Version 1 process list

Now we modify the above command to stop all the listed processes.

kill -s 9 `ps xaf | egrep "JackrabbitRelay|Equilibrium|Procurator" | cut -b-8`

If you repeat the above ps command, all of the previous processes should now be gone and version 1 of Jackrabbit Relay completely shut down.

Now to move and backup everything. We are going to make THREE (3) backup copies of the GitHub folder AND the active JackrabbitRelay folder. Yes, I'm being paranoid, but better safe then sorry, especially with your configuration files.

mkdir -p /home2
cp -lpr /home/GitHub/ /home2/GH.1
cp -lpr /home/GitHub/ /home2/GH.2
cp -lpr /home/GitHub/ /home2/GH.3
cp -lpr /home/JackrabbitRelay/ /home2/JRR.1
cp -lpr /home/JackrabbitRelay/ /home2/JRR.2
cp -lpr /home/JackrabbitRelay/ /home2/JRR.3

At this point, you have three copies of the version 1 GitHub and active Jackrabbit Relay folders.

Now we need to remove the version 1 JackrabbitRelay folder. TAKE YOUR TIME AND CHECK YOUR TYPING CAREFULLY. Be sure you are in the /home/GitHub folder. DOUBLE CHECK EVERYTHING!!

cd /home/GitHub
rm -r JackrabbitRelay

All version 1 files have been removed from the /home/GitHub folder and you are ready to install Version 2. If you have followed ALL of the above, you have THREE (3) backups as a precaution. Proceed with the installation of Version 2.

Installing and setting up Version 2

Please be aware that you may need to switch to your root account. Please follow the necessary instructions provided by your VPS provider. This document assumes you are already at root level or have your virtual environment established, both are beyond the scope of this documentation.

Start with these shell commands

mkdir -p /home/GitHub
cd /home/GitHub
git clone https://github.com/rapmd73/JackrabbitRelay

You now have a copy of the Jackrabbit Relay repository. Now its time to install everything.

cd /home/GitHub/JackrabbitRelay
./install

At this point the files are installed, but more setup is required before Relay is ready to run. Configuring the exchanges and crontab need to be completed next.

Please note that Jackrabbit Relay is not related to the Apache Jackrabbit project. Jackrabbit Relay is a standalone framework and API delivery system for automated algorithmic trading, designed for relaying JSON payloads that contain buy/sell order information between different systems (Charting software, forex brokers, cryptocrrency exchanges using REST). It is developed by Robert Darin and is not affiliated with or endorsed by the Apache Software Foundation or the Apache Jackrabbit project.

If you would like to help support this project financially, please click on the heart shaped sponsor's button in the right column of this page. I also have a merch store with some awesome and really cool products. Please visit supporting Jackrabbit for more options.

All subscriptions/sales go to the costs of sustaining Jackrabbit Relay. Thank you.