How to install, configure and run a Burstcoin Node in Ubuntu 16.04

burstcoin_node_guide_ubuntu.md

How to install, configure and run a Burstcoin Node in Ubuntu 16.04

Guide index

1. Installing and configuring dependencies
2. Creating a new database and assigning privileges
3. Downloading latest BRS release
4. Editing Burst node configuration file
5. Running the node

1. Installing and configuring dependencies.

Before we start configuring our node, we need to install some dependencies: Java and MariaDB.

Let's start with Java: Update your package repository first with apt-get and then download the Java JDK package.

sudo apt-get update
sudo apt-get install default-jdk

After that's done, we can continue with MariaDB.

Download and install MariaDB with:

sudo apt-get install mariadb-server

Secure your MySQL install by running:

sudo mysql_secure_installation

This will ask for your mysql root password (which is not set). Press enter for none and follow the onscreen instructions.

2. Creating a database and assigning privileges

Login into MySQL with sudo mysql -p. Enter the root password you created in the previous step

Now we are going to create the database, a new user with a password and assign some privileges to edit our database. I will use "burst_node" in this example for the database name, but you can choose whatever you want.

CREATE DATABASE burst_node;

Note: Every command needs to ends with a semicolon

Again, for the user creation, im using "burst" as username and "password" for the password in this example. PLEASE modify the password area in the command before executing the command.

CREATE USER 'burst'@'localhost' IDENTIFIED BY 'password';

Now we need to assign privileges to modify the database to our new user. This is done by executing:

GRANT ALL PRIVILEGES ON burst_node . * TO 'burst'@'localhost';

MariaDB config is done. You can exit mysql by typing exit

3. Downloading the latest BRS release

Let's create a new folder for our files before downloading anything.

mkdir burst_files && cd burst_files

You can get the latest release from PoC Consortium Github. This guide uses version 2.2.5 "Mitigator" To start downloading the zip, run:

wget https://github.com/PoC-Consortium/burstcoin/releases/download/2.2.5/burstcoin-2.2.5.zip

And then extract the contents of the zip with unzip.

unzip burstcoin-2.2.5.zip

If you dont have unzip installed, you can get it with apt-get install unzip

4. Editing Burst node configuration file

We only need to edit a few lines in order to make this work, but you are welcome to read the whole configuration file and edit it to fit your needs. Open the configuration file brs-default.properties located in conf folder with your favorite editor. We will use nano in this example.

nano conf/brs-default.properties

These are the only values needed to run the node. Find the following options in your config file and set the values as shown below:

API.allowed = *;0.0.0.0
API.Listen = 0.0.0.0

Remember the username, database name and password entered previously? They go in the config file as well. Find these lines and edit them to match your user, etc.

DB.Url=jdbc:mariadb://localhost:3306/burst_node
DB.Username=burst
DB.Password=password

That's all. Press CTRL+X and then Y to save changes and exit nano.

5. Running the node!

Before running the Burst node, we first need to make the script burst.sh executable, so run sudo chmod +x burst.sh to do this. After that's done, you are ready to launch the node. Execute nohup ./burst.sh & and access the wallet through your browser using the IP Address of your node and port 8125.

http://yournodeip:8125