Qortal Project

The future of blockchain platforms

User Tools

Site Tools


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/14/2021 03:05] lancek99raspberry_pi4 [03/18/2021 02:00] lancek99
Line 1: Line 1:
-====== **RASPBERRY PI SETUP GUIDE** ======+====== 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. For clarity all commands to be typed by you are followed by  ↩ symbol to denote pressing enter key.
-Simply copy and paste the relevant text from this guide into the terminal like this.+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
  
-Right click copy 
 Then right click in terminal Then right click in terminal
  
Line 14: Line 28:
 You will need Java installed on the raspberry pi as well as 7zip. You will need Java installed on the raspberry pi as well as 7zip.
  
-To install them, open a terminal window +To install them, open a terminal window by navigating to the start menu and selecting the Terminal app. 
  
-and get your system up to date using: +#Get your system up to date using: 
 + 
 sudo apt update↩ sudo apt update↩
 +
 The files will be downloaded and installed.  The files will be downloaded and installed. 
-Next we will upgrade the entire system to the latest version using:+Next we will upgrade the entire system to the latest version using: 
 sudo apt full-upgrade↩ sudo apt full-upgrade↩
-It will check what’s needing to be upgraded and a prompt will appear, type y and press enter.+ 
 +It will check what’s needing to be upgraded and a prompt will appear, type y and press enter. 
 y↩ y↩
-Now we will configure the system to allow remote access via ssh and enable RealVNC to view your  Raspberry desktop using a remote computer:+ 
 +Now we will configure the system to allow remote access via ssh to Raspberry using a remote computer: 
 + 
 sudo raspi-config↩ sudo raspi-config↩
-Use your arrow to navigate and enter to select as shown below+ 
-Navigate to the finish button and select and press enter.+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. You will find yourself back in the terminal window.
-Now that your system is up to date, let's install Java:+Now that your system is up to date, let's install Java: 
 sudo apt install default-jdk↩ sudo apt install default-jdk↩
-To check if it’s installed properly, type:+ 
 +To check if it’s installed properly, type: 
 java -version↩ java -version↩
 +
 This will display your currently installed version of java and display something like This will display your currently installed version of java and display something like
 +
 openjdk version "11.0.9.1" 2020-11-04 openjdk version "11.0.9.1" 2020-11-04
 OpenJDK Runtime Environment (build 11.0.9.1+1-post-Raspbian-1deb10u2) OpenJDK Runtime Environment (build 11.0.9.1+1-post-Raspbian-1deb10u2)
Line 40: Line 68:
  
  
-Assuming all went well and Java is installed, we now install 7zip: +Assuming all went well and Java is installed, we now install 7zip: 
-sudo apt-get install p7zip-full -y ↩+ 
 +sudo apt-get install p7zip-full -y↩ 
 It will be done shortly. It will be done shortly.
  
  
  
-Section E - Install Qortal Core on your Raspberry Pi 4.+Install Qortal Core on your Raspberry Pi 4. 
 + 
 +# In the terminal:
  
-In the terminal: 
 wget https://github.com/Qortal/qortal/releases/download/v1.4.3/qortal-1.4.3.zip↩ 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. This will download the core zip file to your PI.
-Now we unzip it with: +Now we unzip it with: 
-unzip qortal-1.4.3.zip↩  + 
-Then enter the newly unzipped Qortal directory using:+unzip qortal-1.4.3.zip↩ 
 +  
 +Then enter the newly unzipped Qortal directory using: 
 cd qortal↩ cd qortal↩
 +
 Now we will download the zipped database file: Now we will download the zipped database file:
  
  
-Type the command+Type the command
 ls↩ ls↩
 +
 This will show you a list of all the files in the Qortal folder. This will show you a list of all the files in the Qortal folder.
 It should look like this It should look like this
  
  
-To download the database type:+                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 ↩ wget https://qortal.tmgoxford.com/db.7z ↩
 +
 Be patient. It’s a huge file and will take a while to complete. 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. When it’s done downloading, your prompt will reappear and you can continue installing.
-Extract the database:+Extract the database: 
 7z x db.7z↩ 7z x db.7z↩
 +
 This will also take quite some time. This will also take quite some time.
 When it’s done extracting, your prompt will reappear and you can continue. 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.+Now you must grant permissions to the scripts in the folder so you can run them
 chmod  a+x *.sh↩ chmod  a+x *.sh↩
-Next we edit the configuration file to optimize for raspberry pi + 
-echo -en "{\n\"maxPeers\":32,\n\"minBlockchainPeers\": 8,\n\"apiDocumentationEnabled\": true\n}\n\"" > settings.json +Next we edit the configuration file to optimise for raspberry pi
-Let’s make sure it did what is required, let’s display the settings.json file by:+ 
 +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↩ cat settings.json↩
 +
 You should get the following 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:
  
-Assuming all went well to this point you can now start the core: 
 ./start.sh↩ ./start.sh↩
  
Line 88: Line 148:
     qortal running as pid (whatever PID digits it assigns)     qortal running as pid (whatever PID digits it assigns)
  
-A moment or two later the logo will appear, center screen  +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.
- +
-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, synchronization %, number of peers you are connected to and the current block height you are at.+
  
 CONGRATULATIONS. Your node is up and running. CONGRATULATIONS. Your node is up and running.
  
 # To stop it gracefully at any point open a terminal: # 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 theUI installed with the following method :+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: 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↩ ssh -L 22391:127.0.0.1:12391 pi@your pi’s local ip address↩
  
Line 114: Line 170:
 Select add custom node Select add custom node
  
-In each dropdown menu, select the following options +In the menu, select the following options
-Protocol=Http, Domain=127.0.0.1, port=22391+
  
-Click add and on the Settings page select your newly added nodeLogin as usual.+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. An expanded version of this guide will be available soon, with the next steps and a list of useful commands.
- 
-