Update: April 27, 2023
The below article was created during the time XYO developed XYO Protocol 1.0. With this being said, the below article is going to be a history piece as these instructions will no longer work for the greatly improved XYO Protocol 2.1!
More to come at a later date with instructions on how to build your own XYO Node. š
About this project
Before we began with this project I would like to let everyone know at the time of this post the archivist software hasn't been activated for use. Creating your archivist at this time will allow you to get ahead the curve and be prepared to have an activated archivist once the XY Team has finished creating the software for the archivist and are ready to go live with decentralizing data across multiple archivists. Currently there is only one active archivist which is alpha-peers.xyo.network.
What is a Archivist?
A node in the XYO network that stores bound witness interactions which has been collected from bridges when sentinels has off loaded the location data when they come within range of the bridge. An archivist can provide data to a Diviner in order to successfully complete a query. Archivists can cover a smaller private collection of bound witness data for an individual user, or all bound witness interactions for the entire network.
Parts Needed
1. Geekworm Raspberry Pi 4 SATA Storage, Raspberry Pi 4 Model B 2.5 inch SATA HDD/SSD Expansion Board X825 USB3.0 Shield Compatible with Raspberry Pi 4B Only
2. Geekworm Raspberry Pi 4 X825 Metal Case+Power Switch+Cooling Fan, Honeycomb Chassis Support X825 2.5 inch SATA SSD/HDD Shield & Raspberry Pi 4 Model B & X735
3. GeeekPi DC 5V 4A Travel Power Adapter with US&EU&UK Plug for Raspberry Pi X820/X825 SATA Expansion Board/ X700 UPS/ X720/ X735 Power Management Board/Jetson Nano/X822/X852/T300/T100/T200/X750
4. Vilros Raspberry Pi 4 4GB Complete Kit with Clear Transparent Fan Cooled Case (4GB)
5. WD Blue 1TB Mobile Hard Drive - 5400 RPM Class, SATA 6 Gb/s, 128 MB Cache, 2.5" - WD10SPZX
6. Keyboard
7. Mouse
Directions to build your Archivist
1. Follow video instructions (https://www.amazon.com/vdp/1cfc3ac6265a47568bb3896986346600?ref=cm_sw_em_r_lb_dt_Gp54vyiEn6kVV) as this will show you how to take the above parts and build your archivist. I didn't purchase the power management board for this project but something you could look into purchasing as this will help with shutting down the archivist safety. Also as an hint do not place the assembled raspberry pi with SDD/HDD shield into the case yet as you will need to follow the instructions in step 1 below on creating your SD Card with PINN. PINN is an alternative bootloader software for your raspberry pi that has more options then the NOOB bootloader for the raspberry pi. PINN will be required as the software has an built-in feature to allow you to install the OS to the SDD/HDD.
2. Once you have an bootable SD Card you are ready to finish the assembly. Place the assemebled raspberry pi into the case as shown in the above video in step 1.
3. Connect your keyboard, mouse, HDMI video cable, and power cable to the archivist.
4. Power on the archivist by pressing the power button on front of the case.
5. Follow instructions below on how to install the Archivist software.
Directions to install Archivist Software
1. Follow instructions on https://github.com/procount/pinn to install PINN to an SD Card. This is required as you can't continue to the next step until you have an bootable SD Card with PINN.
2. Once you have a bootable SD Card with PINN installed you are ready to install Raspbian as your default OK on the raspberry pi. Insert SC Card into the raspberry pi and boot into the PINN software.
3. In PINN you will notice an drop down feature for destination to install the OS to. Make sure you have selected your hard drive installed on the raspberry pi as it will default to the SD card. Once you have changed the destination to the hard drive you are ready to continue to install Raspbian on your raspberry pi.
4. Select Raspbian Full from the OS selection and click Install. This process will take some time as you are downloading a large file from the internet. Please be patient while the OS is installing.
5. Once Raspbian has installed please reboot into the Raspbian OS.
6. Open LxTerminal and type, apt-get update and press enter.
7. Next, type sudo apt-get install mate-core mate-desktop-environment and press enter.
8. Next, type sudo update-alternatives --config x-session-manager and press enter. A selection menu will appear. Type the number corresponding to mate.
9. Type sudo reboot and press enter.
10. Open LxTerminal and type, sudo apt-get update
11. Type, sh -c "$(curl -fsSL https://raw.githubusercontent.com/Linuxbrew/install/master/install.sh)" and press enter. 12. Type, sudo apt-get install build-essential and press enter. 13. Type, echo 'eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv)' >>~/.profile and press enter. 14. Type, eval $(/home/linuxbrew/.linuxbrew/bin/brew shellenv) and press enter. 15. Type, curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.2/install.sh | bash and press enter. 16. Type, export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")" [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm and press enter. 17. Type, curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash - and press enter. 18. Type, sudo apt install nodejs and press enter. 19. Type, brew install yarn and press enter. 20. Type, npm install --global lerna and press enter. 21. Type, npm install @xyo-network/app-xyo-nodejs@alpha -g and press enter.
22. Type, xyolo -i and press enter. This will install the Archivist software. 23. Type, xyolo -r and press enter. This will launch the Archivist software.
Also, make sure you have the USB bridge connector connected to hard drive and SATA HDD Expansion board. If the bridge isn't connected you will not see the hard drive as an selectable item in PINN.
Mine was formated from factory in NTFS. If you don't see the drive in PINN then format to NTFS or standard Linux format EXT4. Once PINN detects the drive, the installation should format the drive to the correct format which should be either EXT3 or EXT4. Not sure off the top of my head which EXT version PINN formats too.
I am very close to completing this project, but I seem to be stuck. What format should the 2.5ā hard drive be prior to booting PINN? The Destiination Drive drop down (alliteration?) doesnāt populate anything :(