¶ 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.
¶ Copy Data from Other Node to RoninDojo
Want to copy the blockchain data from an existing bitcoin node to your RoninDojo bitcoin node?
We will show you how to use the rsync command plus a few others so you can avoid redownloading the chain. Advanced users should be able to adapt these commands to meet their needs.
Before starting, you must have a RoninDojo bitcoin node setup and running!
- RoninDojo SSH remote login into your RoninCLI. Record the IP address for your RoninDojo bitcoin node and save it for later in this guide.
- RoninDojo: Make sure to stop RoninDojo before progressing, otherwise there can be errors!
- Other Node: SSH remote login into your other node, in this example the user has a Mynode which will be called "other node".
- Other Node: Make sure to stop your other node before progressing, otherwise there can be errors!
- Other Node: On your other node, locate the block data directory using the find command.
find / -name blocks
- Other Node: For example if you are using Mynode, then you might get an output like this.
/mnt/hdd/mynode/bitcoin/blocks
- RoninDojo: Run the following command on your RoninDojo to delete any existing block data just in case.
sudo rm -rf /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}
- RoninDojo: Verify the backup directory exists, and if it is not found the mkdir command is used to create it.
ls /mnt/usb/backup || sudo mkdir /mnt/usb/backup
- RoninDojo: Change the backup directory to be temporarily owned by user ronindojo.
sudo chown ronindojo:ronindojo /mnt/usb/backup
- Other Node: Run the rsync command which has been adapted with the proper file paths, username, and IP address of your RoninDojo.
sudo rsync -av /mnt/hdd/mynode/bitcoin/{blocks,chainstate,indexes} ronindojo@192.168.X.X:/mnt/usb/backup
- Other Node: The rsync will take a while to run so please be patient until the transfer completes. Once the transfer is complete you can restore your other node to usual operations.
- RoninDojo: Once the transfer is complete, run the move command to get the blocks/ chainstate/ indexes/ relocated to the bitcoind data directory.
sudo mv /mnt/usb/backup/{blocks,chainstate,indexes} /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/
- RoninDojo: Run the command to change the permissions for blocks/ chainstate/ indexes/ directories.
sudo chown -R 1105:1108 /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}
- RoninDojo: Run the command to restore ownership of the backup/ directory to the root user.
sudo chown root:root /mnt/usb/backup
- RoninDojo: Start your RoninDojo, and check on the logs to make sure everything looks healthy!
¶ WinSCP Copy Data from Windows10 to RoninDojo
Want to download a copy of the blockchain on that speedy Windows gaming computer and transfer to your RoninDojo on the same local network?
We know the blockchain takes a while to download when starting fresh without a backup copy, and want to give power users with high performance computers other options.
Before starting, you must have a RoninDojo bitcoin node setup and running!
-
Windows10: Download bitcoin core, sync the blockchain, and download WinSCP. The blockchain will take a few hours to sync.
-
Windows10: Once synchronized, make sure to close bitcoin core before progressing otherwise there can be errors!
- Windows10: SSH remote login into your RoninCLI device using the Windows command prompt.
- RoninDojo: Make sure to stop RoninDojo before progressing, otherwise there can be errors!
- RoninDojo: Verify the backup directory exists, if it is not found an error will appear, and the mkdir command will create it.
ls /mnt/usb/backup || sudo mkdir /mnt/usb/backup
- RoninDojo: Change the backup directory to be temporarily owned by username ronindojo.
sudo chown ronindojo:ronindojo /mnt/usb/backup
- Windows10: Open WinSCP and type in the hostname of your RoninDojo (local IP address), username (usually ronindojo), and password (same as your SSH password).
- Windows10: Go to
C:\Users\Username\Appdata\Roaming\Bitcoinin Windows file explorer.
- Windows10: In WinSCP, go to
/mnt/usb/backupon your RoninDojo device, then copy over theblockschainstateindexesdirectories from Windows to the RoninDojo device. Wait a couple hours for the transfer to finish.
- Windows10: Once the transfer is finished you can exit WinSCP.
- RoninDojo: Run the following command to delete any existing block data just in case.
sudo rm -rf /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}
- RoninDojo: Run the move command to get the
blockschainstateindexesrelocated to the bitcoind data directory.
sudo mv /mnt/usb/backup/{blocks,chainstate,indexes} /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/
- RoninDojo: Run the command to change the permissions for
blockschainstateindexesdirectories.
sudo chown -R 1105:1108 /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/{blocks,chainstate,indexes}
- RoninDojo: Check if permissions are set properly.
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: Finally, run the following command to restore ownership of the
backupdirectory to the root user.
sudo chown root:root /mnt/usb/backup
- 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.
¶ Additional Info
Need help? Try out our Support Service.
Join the RoninDojo Chatroom and engage the community.