¶ Blockchain Data Salvage
¶ Uninstall
If you choose to uninstall using the command-line interface, a prompt will appear asking if you wish to salvage your Blockchain Data. If salvage is selected, then the data will be preserved for the the next install.
You can uninstall at anytime using the command-line interface menus. This will remove Whirlpool, Explorer, Dojo, and all data related to a RoninDojo device.
System → Next Page → Uninstall RoninDojo
Once a new installation is complete, you will see a prompt that says Press any letter to continue. Once pressed, your Blockchain Data from the previous installation will be salvaged.
Please note that your node will not be fully functional until the indexer compaction is complete, and this process will take about 8 hours.
¶ Clone Micro SD Card
If you are using a non-industrial micro SD card in your RoninDojo node, following these steps will allow you to make a clone to a new industrial micro SD card (like the ones recommend in the hardware section of this wiki).
Inserting your newly cloned industrial micro SD card into your RoninDojo node negates the need to re-pair your Samourai Wallet and Whirlpool GUI.
Cloning your micro SD card should only be carried out if you are free from /dev/mmcblk1p I/O errors.
If you are experiencing I/O errors, you should perform flash a new micro SD card.
NOTICE: the micro SD card you are cloning to has to be of the same size or larger than the micro SD you are cloning from.
You may also wish to clone your micro SD card to serve as a spare. Note however that cloning is a snapshot in time, and post-cloning, any software updates to your RoninDojo node will not be carried across to your spare/cloned micro SD card.
-
Power Off your RoninDojo via the RoninUI or RoninCLI.
RoninUI:Dashboard→RoninDojo→MANAGE→SHUT DOWN
RoninCLI:System→Power Off -
Wait 3 minutes until safe shut down is complete, disconnect power, then remove micro SD card (#1) from RoninDojo node.
-
Download Balena Etcher.
-
Open Balena Etcher, insert micro SD card (#1) into your PC. Press
Clone drive, then select micro SD card (#1)
- Insert industrial micro SD card (#2) into your PC. Press
Select target, select your industrial micro SD card (#2), then pressFlash!.
Note: micro SD card #1 and #2 are to remain inserted in your PC for the duration of cloning.
- Once cloning is complete, "1 successful target" should be displayed with no errors.
-
Remove industrial micro SD (#2) from your PC, and insert into your RoninDojo node.
-
Reapply power, and your node will resume from where it left off. Don't forget to re-enter your Passphrase into the Whirlpool GUI to unlock 24/7 remixes.
¶ Re-flash Micro SD Card
There is another method which should help protect against data loss during sudden lockout from a device. Perhaps you want to avoid troubleshooting something you messed up, are afraid of losing data, or it's just time for a new SD card? Don't worry!
Simply flash a new Micro SD card, leave your SSD plugged in, and setup RoninDojo as if you are a new user. Once RoninDojo is installed again, you will see a prompt that says Press any letter to continue. Press any letter to trigger the data salvage.
Perhaps you changed a setting, or broke something you don't care to fix? Whatever the reason, avoid troubleshooting at your leisure, and let the RoninDojo scripts do the work to recover data for you.
¶ Using RoninDojo with a Secondary Backup Drive
By following the guide below, you will be able to use a secondary drive to store a copy of the blockchain from your RoninDojo. This method can be used to transfer data between two different RoninDojos. Also if RoninDojo ever has a massive failure, having this data on hand will reduce your setup time when starting over.
If done correctly, you could reduce setup time from days to just a few hours. This is because the blockchain takes such a long time to download when starting over.
¶ Setup New Backup Drive:
- NOTICE: You only need to do this step once! All existing data on this new backup drive will be erased when it is formatted for blockchain data backups.
- Connect your new backup SSD or HDD to your RoninDojo. Go to the
ronincommand line menu and select the format new backup drive option.
System → Disk Storage → Format & Mount New Backup Drive
- Your new backup drive is now formatted and ready! Please proceed to steps below.
¶ Send Blockchain Data to New Backup Drive:
- Connect your backup SSD or HDD to your RoninDojo. Go to the Dojo menu, next page, and select the option to send data to the backup drive.
Dojo → Next Page → Send Block Data to Backup
- After the data has finished sending your drive will be unmounted and it is safe to disconnect.
- You can also use this option anytime to add new blockchain data to an already existing backup drive, as the blockchain grows in size over time.
¶ Receive Blockchain Data from Existing Backup Drive:
- Connect your backup SSD or HDD to your RoninDojo. Go back to Dojo menu, next page, and select the option to receive data from the backup drive.
Dojo → Next Page → Receive Block Data from Backup
- Please note that your node will not be fully functional until the indexer compaction is complete. This takes about 10hrs after the data Blockchain Data is finished with sync.
¶ WinSCP Copy Data from Windows10 to RoninDojo
Want to download a copy of the blockchain on that speedy Windows10 video game computer and transfer to your RoninDojo on the same local network?
This will reduce a RoninDojo setup time from about 3 days to around half a day. This is because the blockchain takes such a long time to download when starting fresh without a backup copy.
Before starting, you must have a RoninDojo setup and running!
-
Windows10: Download bitcoin core, sync the blockchain, and download WinSCP. This will take a few hours to complete.
-
Windows10: SSH remote login into your RoninDojo device using the Windows Ubuntu Linux Subsystem from the Windows App Store.
-
Windows10: Make sure to close bitcoin core before progressing, otherwise there can be errors!
-
RoninDojo: Make sure to stop RoninDojo before progressing, otherwise there can be errors!
-
RoninDojo:
sudo mkdir /mnt/usb/bitcoin -
RoninDojo:
Modify with your username!
sudo chown username:username /mnt/usb/bitcoin
-
Windows10: Open WinSCP and type in the hostname of your RoninDojo(local IP address), username, and password.
-
Windows10: Go to
C:\Users\Username\Appdata\Roaming\Bitcoinin Windows file explorer. -
Windows10: In WinSCP, go to
/mnt/usb/bitcoinon your RoninDojo device, then copy over the "blocks", "chainstate", and "indexes" directories from Windows to the RoninDojo device. Wait a couple hours for the transfer to finish. -
Windows10: Once finished you may exit WinSCP.
-
RoninDojo: Type
roninto bring up the menu and stop Dojo. Then exit the menu to return to the command line. -
RoninDojo:
sudo rm -rf /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes} -
RoninDojo:
sudo mv /mnt/usb/bitcoin/{blocks,chainstate,indexes} /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/ -
RoninDojo:
sudo chown -R 1105:1108 /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes} -
RoninDojo:
sudo ls -la /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/|egrep '(blocks|chainstate|indexes)'
You should see something similar to the following if permission are correct:
drwx------ 3 1105 1108 135168 Jul 10 04:20 blocks
drwx------ 2 1105 1108 94208 Jul 10 04:20 chainstate
drwx------ 3 1105 1108 4096 Jul 10 04:20 indexes
-
RoninDojo: If everything looks good, go ahead and start your Dojo from the
ronincommand line menu. -
Please note that your node will not be fully functional until the indexer compaction is complete. This takes about 8hrs after the Blockchain Data is finished transfering.