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.
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 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.
By following the guide below, you will be able to use a secondary drive to store a copy of the blockchain from your RoninDojo. If RoninDojo ever has a massive failure, having this data on hand will reduce your setup time when starting fresh.
If done correctly, you could reduce setup time from days to just a couple of hours. This is because the blockchain takes such a long time to download when starting fresh.
See this playlist for a visual guide. The command-line menus in the video are outdated, and new versions have a new look.
Connect SSD or HDD to your RoninDojo. Go to the ronin
main menu, select system, next page, and finally select format new backup drive option. Take note of the warning that all data on this drive will be erased.
System
→ Disk Storage
→ Format & Mount New Backup Drive
Go back 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.
Mount the drive if it has not been mounted already. Go to the ronin
main menu, select system, next page, and select mount backup drive.
System
→ Disk Storage
→ Mount Existing Backup Drive
Go to the 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 8hrs after the data Blockchain Data is finished with sync.
See this playlist for help as you follow the guide below. The command-line menus in the video are outdated, and new versions have a new look.
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 Windows10 App Store. It is free of charge, and when it asks for microsoft account click cancel.
Windows10: Make sure to close bitcoin core and stop RoninDojo before progressing! If you do not do this you will probably have 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\Bitcoin
in Windows file explorer.
Windows10: In WinSCP, go to /mnt/usb/bitcoin
on your RoninDojo device, then copy over the "blocks" and "chainstate" directories from Windows to the RoninDojo device. If you are confused see 0:35 seconds into this video. Wait a couple hours for the transfer to finish.
Windows10: Once finished you may exit WinSCP.
RoninDojo: Type ronin
to 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}
RoninDojo:
sudo mv /mnt/usb/bitcoin/{blocks,chainstate} /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}
RoninDojo:
sudo ls -la /mnt/usb/docker/volumes/my-dojo_data-bitcoind/_data/|egrep '(blocks|chainstate)'
You should see something similar to the following if permission are correct:
drwx------ 3 1105 1108 131072 Apr 20 04:20 blocks
drwx------ 2 1105 1108 69632 Apr 20 04:20 chainstate
RoninDojo: If everything looks good, go ahead and start your Dojo from the ronin
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.
See the Troubleshooting page for help and info.
Need help? Join the RoninDojo Chatroom.