Qortal Project

The future of blockchain platforms

User Tools

Site Tools

Trace: • port_forwarding
raspberry_pi4

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
raspberry_pi4 [03/16/2021 23:44] – removed gfactorraspberry_pi4 [03/18/2021 02:00] – lancek99
Line 1: Line 1:
 +====== Raspberry Pi4 ======
  
 +How to setup your Raspberry Pi4 device: Assemble your computer.
 +The raspberry pi is a small, single board computer. You will need a second computer to format and install its operating system onto a micro sd card, preferably 128Gb or bigger.
 +
 +Download Raspberry Pi Imager onto your second computer and burn RaspberryPi Os 32bit to your micro sd card. Here's the link [[https://www.raspberrypi.org/blog/raspberry-pi-imager-imaging-utility/]]
 +
 +Here is a link to a complete guide on how to set up the Pi and peripherals. 
 +How to set up your new Raspberry Pi 4 and peripherals ([[https://magpi.raspberrypi.org/articles/set-up-raspberry-pi-4]])
 +
 +How to install Armor Case on your Raspberry Pi 4 ([[https://www.youtube.com/watch?v=5SZkVQ4dd64]])
 +
 +Now that your machine is set up with Raspbian OS, a keyboard and mouse, we can install Qortal.
 +We will be using the Terminal application found in the top left menu to install everything.
 +
 +For clarity all commands to be typed by you are followed by  ↩ symbol to denote pressing enter key.
 +You can also simply copy and paste the relevant text from this guide into the terminal like this:
 +Using your mouse, click and drag the portion to be copied
 +
 +Right click- copy
 +
 +Then right click in terminal
 +
 +And choose  paste
 +
 +Press enter and off you go.
 +
 +You will need Java installed on the raspberry pi as well as 7zip.
 +
 +To install them, open a terminal window by navigating to the start menu and selecting the Terminal app. 
 +
 +#Get your system up to date using:
 + 
 +sudo apt update↩
 +
 +The files will be downloaded and installed. 
 +# Next we will upgrade the entire system to the latest version using:
 +
 +sudo apt full-upgrade↩
 +
 +# It will check what’s needing to be upgraded and a prompt will appear, type y and press enter.
 +
 +y↩
 +
 +# Now we will configure the system to allow remote access via ssh to Raspberry using a remote computer:
 + 
 +sudo raspi-config↩
 +
 +A new window will open.Use your arrow keys to navigate and enter to select.
 +Select option three, to configure peripheral connections and then select and enable SSH. 
 +Navigate to the finish button and press enter.
 +
 +
 +You will find yourself back in the terminal window.
 +# Now that your system is up to date, let's install Java:
 +
 +sudo apt install default-jdk↩
 +
 +# To check if it’s installed properly, type:
 +
 +java -version↩
 +
 +This will display your currently installed version of java and display something like
 +
 +openjdk version "11.0.9.1" 2020-11-04
 +OpenJDK Runtime Environment (build 11.0.9.1+1-post-Raspbian-1deb10u2)
 +OpenJDK Server VM (build 11.0.9.1+1-post-Raspbian-1deb10u2, mixed mode)
 +
 +
 +# Assuming all went well and Java is installed, we now install 7zip:
 +
 +sudo apt-get install p7zip-full -y↩
 +
 +It will be done shortly.
 +
 +
 +
 +Install Qortal Core on your Raspberry Pi 4.
 +
 +# In the terminal:
 +
 +wget https://github.com/Qortal/qortal/releases/download/v1.4.3/qortal-1.4.3.zip↩
 +
 +This will download the core zip file to your PI.
 +# Now we unzip it with:
 +
 +unzip qortal-1.4.3.zip↩
 + 
 +# Then enter the newly unzipped Qortal directory using:
 +
 +cd qortal↩
 +
 +Now we will download the zipped database file:
 +
 +
 +# Type the command:
 +
 +ls↩
 +
 +This will show you a list of all the files in the Qortal folder.
 +It should look like this
 +
 +
 +                log.txt.1   run.log        start.sh
 +log4j2.properties  qortal.jar  settings.json  stop.sh
 +
 +
 +# To download the database type:
 +
 +wget https://qortal.tmgoxford.com/db.7z ↩
 +
 +Be patient. It’s a huge file and will take a while to complete.
 +When it’s done downloading, your prompt will reappear and you can continue installing.
 +# Extract the database:
 +
 +7z x db.7z↩
 +
 +This will also take quite some time.
 +When it’s done extracting, your prompt will reappear and you can continue.
 +# Now you must grant permissions to the scripts in the folder so you can run them:
 +
 +chmod  a+x *.sh↩
 +
 +# Next we edit the configuration file to optimise for raspberry pi:
 +
 +echo -en "{\n\"maxPeers\": 32,\n\"minBlockchainPeers\": 8,\n\"apiDocumentationEnabled\": true\n}\n\"" > settings.json
 +
 +# Let’s make sure it did what is required, let’s display the settings.json file by:
 +
 +cat settings.json↩
 +
 +You should get the following
 +
 +{
 +"maxPeers":32,
 +"minOutboundPeers":16,
 +"minBlockchainPeers":8,
 +"maxNetworkThreadPoolSize":25,
 +"apiDocumentationEnabled":true
 +}
 +
 +# Assuming all went well to this point you can now start the core:
 +
 +./start.sh↩
 +
 +It should tell you it's passed the java version check and give you the PID
 +    Passed Java version check
 +    qortal running as pid (whatever PID digits it assigns)
 +
 +A moment or two later the logo will appear, centre screen and after about 20-30 seconds a small Qortal icon will appear in the top right section of your screen.
 +
 +Give it a minute or two to start making connections and then hover your mouse over the icon. Connection data will appear, synchronisation %, number of peers you are connected to and the current block height you are at.
 +
 +CONGRATULATIONS. Your node is up and running.
 +
 +# To stop it gracefully at any point open a terminal:
 +
 +cd /qortal↩
 +
 +./stop.sh↩
 +
 +Currently it is not easy to setup the User Interface (UI) on the raspberry pi. You can connect the running core on your Raspberry Pi to a second computer that has the UI installed with the following method:
 +On Mac, open the terminal application and tell the mac to set up an SSH connection to your pi using the following command to connect the correct ports:
 +
 +ssh -L 22391:127.0.0.1:12391 pi@your pi’s local ip address↩
 +
 +This takes the output from port 12391 on your pi to port 22391 on your Mac
 +Now we open the UI on the Mac and follow the steps to use this new connection.
 +
 +Select add custom node
 +
 +In the menu, select the following options
 +
 +protocol=http, domain=127.0.0.1, port=22391
 +
 +Click add and on the Settings page and select your newly added node. Login as usual.
 +
 +Instructions for Windows machines will be available shortly or you can ask in Telegram and Discord.
 +
 +An expanded version of this guide will be available soon, with the next steps and a list of useful commands.

Page Tools