mirror of
https://github.com/rootzoll/raspiblitz.git
synced 2024-11-20 10:12:06 +01:00
bluecell296
GitHub
commit
05fa28bdcf
26
FAQ.md
26
FAQ.md
@ -295,9 +295,9 @@ If you are then working in your forked repo and want to update the scripts on yo
|
||||
|
||||
## How to attach the RaspberryPi to the HDD?
|
||||
|
||||
There are multiple ways to do it - just remember it should ne easy to get to the SD card slot for remove and replace the card.
|
||||
There are multiple ways to do it - just remember it should be easy to get to the SD card slot to remove and replace the card.
|
||||
|
||||
Here is an example to use [Hook-and-loop fastener](https://en.wikipedia.org/wiki/Hook-and-loop_fastener) Tape:
|
||||
Here is an example to use [Hook-and-loop fastener](https://en.wikipedia.org/wiki/Hook-and-loop_fastener) tape:
|
||||
|
||||
|
||||
|
||||
@ -313,7 +313,7 @@ Also there are first free 3D open source files in this repo in the directory `ca
|
||||
|
||||
## Are those "Under-Voltage detected" warnings a problem?
|
||||
|
||||
When your USB power adapter for the RaspiBlitz delivers to low power those messages with "Under-Voltage detected" (undervoltage) are shortly seen on the display. If you see those just one or two times thats not OK, but can be in a tolerant window. Nevertheless make sure your USB power adapter can deliver at least 3A. If you still see those warnings maybe get a second USB Power adapter just for the HDD and power the HDD thru a Y-Cable - see https://en.wikipedia.org/wiki/Y-cable#USB
|
||||
When your USB power adapter for the RaspiBlitz delivers too low power those messages with "Under-Voltage detected" (undervoltage) are shortly seen on the display. If you see those just one or two times that's not OK, but can be in a tolerant window. Nevertheless make sure your USB power adapter can deliver at least 3A. If you still see those warnings maybe get a second USB Power adapter just for the HDD and power the HDD through a Y-Cable - see https://en.wikipedia.org/wiki/Y-cable#USB
|
||||
|
||||
## Why do we need to download the blockchain and not syncing it?
|
||||
|
||||
@ -321,17 +321,17 @@ The RaspiBlitz is powered by the RaspberryPi. The processing power of this Singl
|
||||
|
||||
## Is using the perpared SD card image secure?
|
||||
|
||||
Using pre-build software almost always shifts trust to the one how build made the binary. But at least you can check with the SHA checksum after download if the image downloaded is really the one offered by the GitHub Repo. To do so make a quick check if your browser is really in the correct GiutHub page and that your HTTPS of the GitHub page is signed by 'DigiCert'. Then compare the SHA-256 string (always next to the download link of the image on the README) with the result of the command `shasum -a 256 [DOWNLOADED-FILE-TO-CHECK]` (Mac/Linux). Still this is not optimal and if at least some people from the community request it, I will consider signing the download as an author for the future.
|
||||
Using pre-built software almost always shifts trust to the one who made the binary. But at least you can check with the SHA checksum after download if the image downloaded is really the one offered by the GitHub Repo. To do so make a quick check if your browser is really in the correct GiutHub page and that your HTTPS of the GitHub page is signed by 'DigiCert'. Then compare the SHA-256 string (always next to the download link of the image on the README) with the result of the command `shasum -a 256 [DOWNLOADED-FILE-TO-CHECK]` (Mac/Linux). Still this is not optimal and if at least some people from the community request it, I will consider signing the download as an author for the future.
|
||||
|
||||
The best way would be to build the sd card yourself. You use the script `build_sdcard.sh` for it. Take some minutes to check if you see any suspicious in that build script and then follow the [README](README.md#build-the-sd-card-image) on this.
|
||||
The best way would be to build the sd card yourself. You use the script `build_sdcard.sh` for it. Take some minutes to check if you see anything suspicious in that build script and then follow the [README](README.md#build-the-sd-card-image) on this.
|
||||
|
||||
## Is downloading the blockchain from a third party secure?
|
||||
|
||||
To download a blockchain from a third party (torrent/ftp) is not optimal and for the future with more cheap & powerfull SingleBoardComputers we could get rid of this 'patch'.
|
||||
|
||||
The downloaded Blockchain is pre-indexed and pre-validated. That should be practical secure enough, because if the user gets a "manipulated" blockchain it would not work after setup. The beginning of the downloaded blockchain needs to fit the genesis block (in bitcoind software) and the end of the downloaded blockchain needs not match with the rest of the bitcoin network state - hashes of new block distrubuted within the peer-2-peer network need to match the downloaded blockchain head. So if you downloaded a manipulated blockchain it would simply just dont work in practice. As long as you are not in a total hostile environment where someone would be able to fake a whole network of peers and miners around you - this is secure enough for running a small funded full node to try out the lightning network.
|
||||
The downloaded blockchain is pre-indexed and pre-validated. That should be practically secure enough, because if the user gets a "manipulated" blockchain it would not work after setup. The beginning of the downloaded blockchain needs to fit the genesis block (in bitcoind software) and the end of the downloaded blockchain needs not match with the rest of the bitcoin network state - hashes of new block distrubuted within the peer-2-peer network need to match the downloaded blockchain head. So if you downloaded a manipulated blockchain it would simply just don't work in practice. As long as you are not in a totally hostile environment where someone would be able to fake a whole network of peers and miners around you - this is secure enough for running a small funded full node to try out the lightning network.
|
||||
|
||||
If you dont trust the download or you want to run the RaspiBlitz in a more production like setup (on your own risk) then dont use the torrent/ftp download and choose the option to COPY the blockchain data from a more powerful computer (laptop or desktop) where you synced, veryfied and indexed the blockchain all by your yourself - see [README](README.md#4-copying-from-another-computer) for more details.
|
||||
If you dont trust the download or you want to run the RaspiBlitz in a more production like setup (on your own risk) then don't use the torrent/ftp download and choose the option to COPY the blockchain data from a more powerful computer (laptop or desktop) where you synced, verified and indexed the blockchain all by your yourself - see [README](README.md#4-copying-from-another-computer) for more details.
|
||||
|
||||
## What is the "Base Torrent File"?
|
||||
|
||||
@ -352,7 +352,7 @@ So for example the second version of the base torrent for litecoin created on 20
|
||||
|
||||
## What is the "Update Torrent File" and how to create it?
|
||||
|
||||
All the rest of the files get packaged into a second torrent file. This file will be updated much more often. The seeding is expected to be not that good and download may be slower, but thats OK because its a much smaller file.
|
||||
All the rest of the files get packaged into a second torrent file. This file will be updated much more often. The seeding is expected to be not that good and download may be slower, but that's OK because it's a much smaller file.
|
||||
|
||||
This way a good balance between good seeding and up-to-date blockchain can be reached.
|
||||
|
||||
@ -385,7 +385,7 @@ scp -r bitcoin@[RaspiBlitzIP]:/mnt/hdd/bitcoin/chainstate ./chainstate
|
||||
scp -r bitcoin@[RaspiBlitzIP]:/mnt/hdd/bitcoin/indexes ./indexes
|
||||
```
|
||||
|
||||
Also have a almost 100% synced bitcoind TESTNET with txindex=1 on a RaspiBlitz
|
||||
Also have an almost 100% synced bitcoind TESTNET with txindex=1 on a RaspiBlitz
|
||||
|
||||
Stop bitcoind with:
|
||||
```
|
||||
@ -404,7 +404,7 @@ sudo rm /mnt/hdd/bitcoin/testnet3/blocks/rev000*.dat
|
||||
sudo rm /mnt/hdd/bitcoin/testnet3/blocks/rev00{100..152}.dat
|
||||
```
|
||||
|
||||
Now change again to your computer where you package the torrent files and transfere the three directories into your torrent base directory (should be your current working directory):
|
||||
Now change again to your computer where you package the torrent files and transfer the three directories into your torrent base directory (should be your current working directory):
|
||||
```
|
||||
mkdir testnet3
|
||||
scp -r bitcoin@[RaspiBlitzIP]:/mnt/hdd/bitcoin/testnet3/blocks ./testnet3/blocks
|
||||
@ -416,7 +416,7 @@ scp -r bitcoin@[RaspiBlitzIP]:/mnt/hdd/bitcoin/testnet3/indexes ./testnet3/index
|
||||
|
||||
`raspiblitz-[CHAINNETWORK][BASEITERATIONNUMBER]-[YEAR]-[MONTH]-[DAY]-update.torrent`
|
||||
|
||||
*So for exmaple an update torrent created on 2018-12-24 for litecoin that is an update to the second base torrent version would have this name: raspiblitz-litecoin2-2018-12-24-update.torrent*
|
||||
*So for example an update torrent created on 2018-12-24 for litecoin that is an update to the second base torrent version would have this name: raspiblitz-litecoin2-2018-12-24-update.torrent*
|
||||
|
||||
Now open your torrent client (e.g. qTorrent for OSX) and create a new torrent-file with the freshly renamed "torrent base directory" as source directory.
|
||||
|
||||
@ -431,7 +431,7 @@ udp://open.demonii.si:1337/announce
|
||||
udp://denis.stalker.upeer.me:6969/announce
|
||||
```
|
||||
|
||||
After successful crreation of the torrent file:
|
||||
After successful creation of the torrent file:
|
||||
* copy to `/home.admin/assets`
|
||||
* push to master
|
||||
* change in `50torrentHDD.sh script`
|
||||
@ -487,4 +487,4 @@ When you put in a sd card with a new/clean RaspiBlitz image the RaspiBlitz will
|
||||
|
||||
But there might be cases where you want to start a totally fresh/clean RaspiBlitz from the beginning. To do so you need to delete the old data from the HDD. You can do so by formating it on another computer (for example with FAT and name it "NEW"). Or when you can run the script "/home/admin/XXcleanHD.sh -all" on the terminal.
|
||||
|
||||
When the HDD is clean, then flash a new RaspiBlitz sd card and your setup should start fresh.
|
||||
When the HDD is clean, then flash a new RaspiBlitz sd card and your setup should start fresh.
|
||||
|
||||
@ -493,13 +493,13 @@ Use if the want to remove all funds from the RaspiBlitz.
|
||||
|
||||
#### OFF: PowerOff RaspiBlitz
|
||||
|
||||
A saf way to shutdown the RaspiBlitz. If then a reboot/restart is needed - un/replug the power.
|
||||
A safe way to shutdown the RaspiBlitz. If then a reboot/restart is needed - un/replug the power.
|
||||
|
||||
#### X: Console Terminal
|
||||
|
||||
Closes the SSH main menu and exits tothe terminal - where the user can make use of the CLI clients `bitcoin-cli` & `lncli` directly to make use of the Bitcoin- and Lightningnode.
|
||||
Closes the SSH main menu and exits to the terminal - where the user can make use of the CLI clients `bitcoin-cli` & `lncli` directly to make use of the Bitcoin- and Lightningnode.
|
||||
|
||||
With the command `raspiblitz` its possible to return to the main menu.
|
||||
With the command `raspiblitz` it's possible to return to the main menu.
|
||||
|
||||
## Interface / APIs
|
||||
|
||||
@ -578,4 +578,4 @@ Join me on twitter [@rootzoll](https://twitter.com/rootzoll), visit us at a upco
|
||||
|
||||
* [How can I get further help/support?](#support)
|
||||
|
||||
IRC channel on Freenode `irc://irc.freenode.net/raspiblitz` (unmoderated)
|
||||
IRC channel on Freenode `irc://irc.freenode.net/raspiblitz` (unmoderated)
|
||||
|
||||
@ -192,7 +192,7 @@ if [ ${setupStep} -eq 0 ]; then
|
||||
# old data setup
|
||||
BACKTITLE="RaspiBlitz - Manual Update"
|
||||
TITLE="⚡ Found old RaspiBlitz Data on HDD ⚡"
|
||||
MENU="\n ATTENTION: OLD DATA COULD COINTAIN FUNDS\n"
|
||||
MENU="\n ATTENTION: OLD DATA COULD CONTAIN FUNDS\n"
|
||||
OPTIONS+=(MANUAL "read how to recover your old funds" \
|
||||
DELETE "erase old data, keep blockchain, reboot" )
|
||||
HEIGHT=11
|
||||
@ -468,8 +468,9 @@ case $CHOICE in
|
||||
;;
|
||||
MANUAL)
|
||||
echo "************************************************************************************"
|
||||
echo "PLEASE open in browser for more information:"
|
||||
echo "https://github.com/rootzoll/raspiblitz#recover-your-coins-from-a-failing-raspiblitz"
|
||||
echo "PLEASE go to RaspiBlitz FAQ:"
|
||||
echo "https://github.com/rootzoll/raspiblitz"
|
||||
echo "And check: How can I recover my coins from a failing RaspiBlitz?"
|
||||
echo "************************************************************************************"
|
||||
exit 0
|
||||
;;
|
||||
|
||||
@ -6,7 +6,20 @@ source /home/admin/raspiblitz.info
|
||||
# get local ip
|
||||
localip=$(ip addr | grep 'state UP' -A2 | tail -n1 | awk '{print $2}' | cut -f1 -d'/')
|
||||
|
||||
# additional prep if this is used to replace corrupted blockchain
|
||||
if [ "${setupStep}" = "100" ]; then
|
||||
# warn user
|
||||
echo "!! Press ENTER to delete the old blockchain .. CTRL+C to CANCEL"
|
||||
read key
|
||||
# make sure services are not running
|
||||
echo "stopping servcies ..."
|
||||
sudo systemctl stop lnd
|
||||
sudo systemctl stop bitcoind
|
||||
fi
|
||||
|
||||
|
||||
# create bitcoin base directory and link with bitcoin user
|
||||
echo "delete and create new blockchain directory ..."
|
||||
sudo rm -rf /mnt/hdd/bitcoin 2>/dev/null
|
||||
sudo rm -rf /home/bitcoin/.bitcoin 2>/dev/null
|
||||
sudo mkdir /mnt/hdd/bitcoin
|
||||
@ -14,6 +27,7 @@ sudo chown bitcoin:bitcoin /mnt/hdd/bitcoin
|
||||
sudo ln -s /mnt/hdd/bitcoin /home/bitcoin/.bitcoin
|
||||
|
||||
# check setup
|
||||
echo "checking setup ..."
|
||||
sudo touch /home/bitcoin/.bitcoin/test.txt
|
||||
createdCorerct=$(sudo ls /mnt/hdd/bitcoin/test.txt | grep -c 'test.txt')
|
||||
sudo rm /home/bitcoin/.bitcoin/test.txt
|
||||
@ -23,6 +37,7 @@ if [ ${createdCorerct} -eq 0 ]; then
|
||||
echo "FAILED: sudo ln -s /mnt/hdd/bitcoin /home/bitcoin/.bitcoin"
|
||||
echo "Press ENTER to get back to menu ..."
|
||||
read key
|
||||
exit 1
|
||||
fi
|
||||
|
||||
clear
|
||||
@ -80,8 +95,8 @@ if [ ${count} -gt 0 ]; then
|
||||
echo "Found data in /mnt/hdd/bitcoin/indexes/txindex"
|
||||
anyDataAtAll=1
|
||||
fi
|
||||
if [ ${count} -lt 5200 ]; then
|
||||
echo "FAIL: less then 5200 .ldb files (${count}) in /mnt/hdd/bitcoin/chainstate (transfere seems invalid)"
|
||||
if [ ${count} -lt 1500 ]; then
|
||||
echo "FAIL: less then 1500 .ldb files (${count}) in /mnt/hdd/bitcoin/indexes/txindex (transfere seems invalid)"
|
||||
quickCheckOK=0
|
||||
fi
|
||||
|
||||
@ -121,4 +136,6 @@ fi
|
||||
if [ ${setupStep} -lt 100 ]; then
|
||||
# setup script will decide the next logical step
|
||||
/home/admin/10setupBlitz.sh
|
||||
else
|
||||
"DONE - reboot is needed: sudo shutdown -r now"
|
||||
fi
|
||||
@ -11,6 +11,6 @@ echo "OK"
|
||||
|
||||
echo " "
|
||||
echo "Will shutdown now."
|
||||
echo "Wait until Respebarry LEDs show now activity anymore."
|
||||
echo "Wait until Raspberry LEDs show no activity anymore."
|
||||
echo "Then remove SD card and make an release image from it."
|
||||
sudo shutdown now
|
||||
|
||||
@ -212,7 +212,7 @@ if [ ${hddIsAutoMounted} -eq 0 ]; then
|
||||
echo "OK - No config file found: ${configFile}" >> $logFile
|
||||
fi
|
||||
|
||||
# check if HDD cointains existing LND data (old RaspiBlitz Version)
|
||||
# check if HDD contains existing LND data (old RaspiBlitz Version)
|
||||
echo "Check if HDD contains existing LND data .." >> $logFile
|
||||
lndDataExists=$(ls /mnt/hdd/lnd/lnd.conf | grep -c '.conf')
|
||||
if [ ${lndDataExists} -eq 1 ]; then
|
||||
|
||||
Loading…
Reference in New Issue
Block a user