From 9e8a42dc8268d415410246e4e9a3e14b309c39c1 Mon Sep 17 00:00:00 2001 From: openoms Date: Mon, 18 Feb 2019 22:16:33 +0000 Subject: [PATCH] general guide for dietpi --- FAQ.md | 5 ++ dietpi/Odroid_HC1_HC2.md | 121 ++++++++++++++++++++++++++++++++++++ dietpi/README.md | 129 +++++++++++---------------------------- 3 files changed, 160 insertions(+), 95 deletions(-) create mode 100644 dietpi/Odroid_HC1_HC2.md diff --git a/FAQ.md b/FAQ.md index 7e5f57626..eda7d0fb9 100644 --- a/FAQ.md +++ b/FAQ.md @@ -506,3 +506,8 @@ You could try to re-index, but that can take some very long time - multiple days Another option would be to delete the old blockchain and get a new one. See for details the FAQ question: [I have the full blockchain on another computer. How do I copy it to the RaspiBlitz?](FAQ.md#i-have-the-full-blockchain-on-another-computer-how-do-i-copy-it-to-the-raspiblitz). And even if you are not able to delete the data, first rename the undeletable folders and then follow the instructions. Also make sure to check again on your power supply - it needs to deliver equal or more then 3A and should deliver a stable current. If you think your HDD is degrading - maybe this is a good time to replace it. See for details the FAQ question: [How can I recover my coins from a failing RaspiBlitz?](FAQ.md#how-can-i-recover-my-coins-from-a-failing-raspiblitz) + +## Can I flip the screen? + +For the default 3.5" LCD you need to edit the /boot/config.txt. Run `sudo nano /boot/config.txt` +look for the line `dtoverlay=tft35a:rotate=270` towards the end. To flip the screen with 180 degrees change the line to `dtoverlay=tft35a:rotate=90` and reboot with `sudo reboot`. Reference: https://github.com/goodtft/LCD-show/issues/34 \ No newline at end of file diff --git a/dietpi/Odroid_HC1_HC2.md b/dietpi/Odroid_HC1_HC2.md new file mode 100644 index 000000000..84746af69 --- /dev/null +++ b/dietpi/Odroid_HC1_HC2.md @@ -0,0 +1,121 @@ + +![](pictures/DroidBlitz.jpg) + + +## Download the fully prebuilt RaspiBlitz-on-DietPi SDcard image for the Odroid HC1 / HC2 / XU3 / XU4 + +for the Odroid HC1 / HC2 / XU3 / XU4 from this [torrent](https://github.com/openoms/raspiblitz/blob/raspiblitz-dev/dietpi/RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.torrent) or from [mega.nz](https://mega.nz/#F!EVNAAQiB!ZyLHP2dJMRSVjZOTCQMIYA). +(sha256sum RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.img: +96ee8700f52a12fb5b13fab3fffcdcf5d364c6dd16c580d969e421cef2cd7cc2) + +Steps to run: +- download the .img file, +- burn to a 16 GB SD with [Etcher](https://www.balena.io/etcher/) +- extend the rootFS partition with a partition manager (disks, Gparted, etc.) +- boot the Odroid with the SDcard and login with ssh admin@at.your.raspiblitz.ip, password: raspiblitz + +Using this image you can skip the rest of this guide as it is mostly about how this image was built. + +The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation) + +--- +## Setting up the DietPi OS + +### Download the updated DietPi image + +For the Odroid HC1 / HC2 / XU3 / XU4 a v6.20.6 DietPi image with fail2ban installed is uploaded [here]( +https://mega.nz/#!AcdVBAbR!O-W3jP5LUgw7lMY8S9XcBWcKX3IhRNAAFmaYzDXIUC0). (sha256sum DietPi_v6.20.6_OdroidXU4-ARMv7-Stretch.img: +1459b91f66b9db98f3437c31231e44497b7b7dcd9146d2cc41a3da653f9a9215) + +Burn to the SDCard with [Etcher](https://www.balena.io/etcher/) and extend the rootfs partition to the size of your card with a partition manager. + +Insert the SDcard into the Odroid. + +Power up and continue with: [Run the DietPi optimized Raspiblitz SDcard build script](#Run-the-RaspiBlitz-build_sdcard.sh-script) + +### Build your own DietPi image: + +Watch out this an ardous process. +Updating from a v6.14 DietPi image is causing a bootloop under some circumstances. Will be sorted once the current, >6.2 version is uploaded for the Odroids. + +For the Odroid HC1 / HC2 / XU3 / XU4 the start is this image: +https://dietpi.com/downloads/images/DietPi_OdroidXU4-ARMv7-Stretch.7z +Burn it to the SD with [Etcher](https://www.balena.io/etcher/) + +Getting started with DietPi: https://dietpi.com/phpbb/viewtopic.php?f=8&t=9#p9 + +In the desktop terminal on Linux / MacOS or Putty on Windows: + +`ssh root@[IP-OF-DIETPI]` +password: `dietpi` + +Ok > Cancel > Cancel +automatic apt update & apt upgrade and asks to reboot +![](pictures/dietpi_1st_reboot.png) + +`ssh root@[IP-OF-DIETPI]` +after the previous update the ssh keys might change: + +@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ +@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @ +@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ + +run (can be copied from the terminal output): +`ssh-keygen -f "/home/[your-linux-username]/.ssh/known_hosts" -R "dietpi.IP"` + +`ssh root@[IP-OF-DIETPI]` +yes > +password: `dietpi` + +At this point if the DietPi was not updated from 6.14 it does not manage to save settings going forward. +Exit the sotware installer (press Tab to jump to Exit) +![](pictures/dietpi-software_exit.png) + +in the bash prompt run: +`dietpi-update` +>Ok > Cancel the recovery point +update > >Opt out of survey > Ok +Reboots + +`ssh root@[IP-OF-DIETPI]` +password: `dietpi` + +>Ok > Cancel > Cancel +Search `fail2ban` > Space to select > Enter +SSH server > switch from Dropbear to the OpenSSH-server +> Install > Ok +>Opt out of survey > Ok +Reboots again + +Changing the SSH server will change the SSH keys again. To clear: +`ssh-keygen -f "/home/[your-linux-username]/.ssh/known_hosts" -R "dietpi.IP"` + + +## Run the RaspiBlitz build_sdcard.sh script + +In the desktop terminal in Linux / MacOS or Putty in Windows: + +`ssh root@[IP-OF-DIETPI]` +password: `dietpi` +Should end up here on version v6.20.6 or higher: +![](pictures/bash_prompt.png) + +run the build_sdcard.sh script in this format: +`wget https://raw.githubusercontent.com/[GITHUB-USERNAME]/raspiblitz/[BRANCH]/build_sdcard.sh && sudo bash build_sdcard.sh [BRANCH] [GITHUB-USERNAME]` + +Be aware of that the fork needs to be called `raspiblitz` for the git download to work. +if you intend to use @openoms`s forked version: + +`wget https://raw.githubusercontent.com/openoms/raspiblitz/raspiblitz-dev/build_sdcard.sh && sudo bash build_sdcard.sh raspiblitz-dev openoms` + + +`ssh admin@[IP-OF-DROIDBLITZ]` +password: raspiblitz + +The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation) + +--- +### Examples of copying the blockchain data from a HDD using a powered USB to SATA adapter + +![example setup](pictures/HDD_copy_example.jpg) +![](pictures/adapterHDD_HC1.jpg) diff --git a/dietpi/README.md b/dietpi/README.md index 5fda12966..8a993dc15 100644 --- a/dietpi/README.md +++ b/dietpi/README.md @@ -1,4 +1,4 @@ -# ⚡️ RaspiBlitz on DietPi ⚡️ +# ⚡️ RaspiBlitz-on-DietPi ⚡️ # A hardware agnostic platform @@ -9,128 +9,67 @@ This guide was tested on: * Raspberry Pi 3 B Plus - no LCD support so far * hoping to extend this list with more compatible boards especially the ROCK64 -See the hardware specs: [hardware specs](hw_comparison.md). +See the [hardware comparison](hw_comparison.md). -![](pictures/DroidBlitz.jpg) - -## Download the fully prebuilt RaspiBlitz on DietPi SDcard image - -for the Odroid HC1 / HC2 / XU3 / XU4 from this [torrent](https://github.com/openoms/raspiblitz/blob/raspiblitz-dev/dietpi/RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.torrent) or from [mega.nz](https://mega.nz/#F!EVNAAQiB!ZyLHP2dJMRSVjZOTCQMIYA). -(sha256sum RaspiBlitz1.0_OdroidHC1_DietPi6.21.1.img: -96ee8700f52a12fb5b13fab3fffcdcf5d364c6dd16c580d969e421cef2cd7cc2) - -Steps to run: -- download the .img file, -- burn to a 16 GB SD with [Etcher](https://www.balena.io/etcher/) -- extend the rootFS partition with a partition manager (disks, Gparted, etc.) -- boot the Odroid with the SDcard and login with ssh admin@at.your.raspiblitz.ip, password: raspiblitz - -Using this image you can skip the rest of this guide as it is mostly about how this image was built. - -The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation) - +### Downloads and walkthrough for the [Odroid HC1 / HC2 / XU3 / XU4](Odroid_HC1_HC2.md) --- -## Setting up the DietPi OS - -### Download the updated DietPi image +## General Guide for RaspiBlitz-on-DietPi -For the Odroid HC1 / HC2 / XU3 / XU4 a v6.20.6 DietPi image with fail2ban installed is uploaded [here]( -https://mega.nz/#!AcdVBAbR!O-W3jP5LUgw7lMY8S9XcBWcKX3IhRNAAFmaYzDXIUC0). (sha256sum DietPi_v6.20.6_OdroidXU4-ARMv7-Stretch.img: -1459b91f66b9db98f3437c31231e44497b7b7dcd9146d2cc41a3da653f9a9215) +### Setting up the DietPi OS -Burn to the SDCard with [Etcher](https://www.balena.io/etcher/) and extend the rootfs partition to the size of your card with a partition manager. +* Start with an ARM based Single Board Computer listed on DietPi.com. +At least 1GB RAM is recommended. +Look for the SD card image for the specific SBC in the [download section](https://dietpi.com/#download). -Insert the SDcard into the Odroid. +* Burn the image to the SDCard with [Etcher](https://www.balena.io/etcher/) and extend the rootfs partition to the size of your card with a partition manager. -Power up and continue with: [Run the DietPi optimized Raspiblitz SDcard build script](#Run-the-RaspiBlitz-build_sdcard.sh-script) +* Insert the SDcard into your SBC. -### Build your own DietPi image: +* Connect the HDD with a powered suitably powered adapter. +A USB 2.0 port will not be able to power an HDD so you will need extra cable +If you are connecting the HDD to a USB 3.0 port and have an at least 2A power supply, you might be able to run without an extra cable. -Watch out this an ardous process. -Updating from a v6.14 DietPi image is causing a bootloop under some circumstances. Will be sorted once the current, >6.2 version is uploaded for the Odroids. +* Power up and continue with: [Run the DietPi optimized Raspiblitz SDcard build script](#Run-the-RaspiBlitz-build_sdcard.sh-script) -For the Odroid HC1 / HC2 / XU3 / XU4 the start is this image: -https://dietpi.com/downloads/images/DietPi_OdroidXU4-ARMv7-Stretch.7z -Burn it to the SD with [Etcher](https://www.balena.io/etcher/) - -Getting started with DietPi: https://dietpi.com/phpbb/viewtopic.php?f=8&t=9#p9 - -In the desktop terminal on Linux / MacOS or Putty on Windows: + +* In the desktop terminal on Linux / MacOS or Putty on Windows: `ssh root@[IP-OF-DIETPI]` password: `dietpi` +Getting started with DietPi: https://dietpi.com/phpbb/viewtopic.php?f=8&t=9#p9 -Ok > Cancel > Cancel -automatic apt update & apt upgrade and asks to reboot -![](pictures/dietpi_1st_reboot.png) - -`ssh root@[IP-OF-DIETPI]` -after the previous update the ssh keys might change: - -@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ -@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @ -@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ - -run (can be copied from the terminal output): -`ssh-keygen -f "/home/[your-linux-username]/.ssh/known_hosts" -R "dietpi.IP"` - -`ssh root@[IP-OF-DIETPI]` -yes > -password: `dietpi` - -At this point if the DietPi was not updated from 6.14 it does not manage to save settings going forward. -Exit the sotware installer (press Tab to jump to Exit) -![](pictures/dietpi-software_exit.png) - -in the bash prompt run: -`dietpi-update` ->Ok > Cancel the recovery point -update > >Opt out of survey > Ok -Reboots - -`ssh root@[IP-OF-DIETPI]` -password: `dietpi` - ->Ok > Cancel > Cancel -Search `fail2ban` > Space to select > Enter -SSH server > switch from Dropbear to the OpenSSH-server -> Install > Ok ->Opt out of survey > Ok -Reboots again +* You might be asked about updating DietPi. This might not be straightforward if starting froma version <6.20. Try to update, it is best to build on the latest version. +* In the DietPi software menu install fail2ban and make OpenSSH server the default SSH server. Changing the SSH server will change the SSH keys again. To clear: `ssh-keygen -f "/home/[your-linux-username]/.ssh/known_hosts" -R "dietpi.IP"` - -## Run the RaspiBlitz build_sdcard.sh script - -In the desktop terminal in Linux / MacOS or Putty in Windows: - +* After every reboot log back in: `ssh root@[IP-OF-DIETPI]` -password: `dietpi` -Should end up here on version v6.20.6 or higher: +password: `dietpi` + +* Should end up here on version v6.20.6 or higher: ![](pictures/bash_prompt.png) -run the build_sdcard.sh script in this format: -`wget https://raw.githubusercontent.com/[GITHUB-USERNAME]/raspiblitz/[BRANCH]/build_sdcard.sh && sudo bash build_sdcard.sh [BRANCH] [GITHUB-USERNAME]` -Be aware of that the fork needs to be called `raspiblitz` for the git download to work. -if you intend to use @openoms`s forked version: +### Run the RaspiBlitz build_sdcard.sh script -`wget https://raw.githubusercontent.com/openoms/raspiblitz/raspiblitz-dev/build_sdcard.sh && sudo bash build_sdcard.sh raspiblitz-dev openoms` +* Format of the command to build the SDcard: +`wget https://raw.githubusercontent.com/[GITHUB-USERNAME]/raspiblitz/[BRANCH]/build_sdcard.sh && sudo bash build_sdcard.sh [BRANCH] [GITHUB-USERNAME]` +If you are working from a forked repo be aware of that the fork needs to be called `raspiblitz` for the git downloads to work. +* Run the forked version of @openoms: +`wget https://raw.githubusercontent.com/openoms/raspiblitz/raspiblitz-dev/build_sdcard.sh && sudo bash build_sdcard.sh raspiblitz-dev openoms` +This will take a couple minutes depending on your internet ceonnection and the processing power of the SBC. +* Restart when done and log back in now as `admin`: `ssh admin@[IP-OF-DROIDBLITZ]` -password: raspiblitz +password: `raspiblitz` -The setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation) +* From here he setup continues with the [RaspiBlitz Setup Process](https://github.com/rootzoll/raspiblitz/blob/master/README.md#setup-process-detailed-documentation) ---- -### Examples of copying the blockchain data from a HDD using a powered USB to SATA adapter -![example setup](pictures/HDD_copy_example.jpg) -![](pictures/adapterHDD_HC1.jpg) --- ### Useful commands for debugging: @@ -144,7 +83,7 @@ To test a new configuration run XXcleanHDD.sh and strictly restart `sudo tail -n100 /mnt/hdd/bitcoin/debug.log` - shows the last 100 lines `sudo systemctl status lnd` `sudo journalctl -f -u lnd` -`./home/admin/XXdebugLogs.sh` - debug log collection on the raspiblitz +`./home/admin/XXdebugLogs.sh` - debug log collection on the RaspiBlitz ---