Qortal Project

The future of blockchain platforms

User Tools

Site Tools


qortector_walkthrough

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
qortector_walkthrough [04/20/2022 20:54] gfactorqortector_walkthrough [12/13/2022 19:56] (current) gfactor
Line 2: Line 2:
 {{::26a9e220-7c52-4706-825f-0beb6007acb4.png?400|}} {{::26a9e220-7c52-4706-825f-0beb6007acb4.png?400|}}
  
-**Please note: this guide is for setting up your QORTector after it has been imaged. This video can be used for both those who purchased from https://crowetic.com or built on using the [[Raspberry Pi 4]] help guide! The video below is a walkthrough guide of the SinclairMATE image.**+**Please note: this guide is for setting up your QORTector after it has been imaged. This video can be used for both those who purchased from https://crowetic.com or built on using the [[Raspberry Pi 4]] help guide!**
  
 ===== Setting Up Your QORTector ===== ===== Setting Up Your QORTector =====
Line 8: Line 8:
 **Important: Do NOT run the QORTector if fan isn’t running after powering the device!** The fan needs to be running to prevent the board from overheating. **Important: Do NOT run the QORTector if fan isn’t running after powering the device!** The fan needs to be running to prevent the board from overheating.
  
-Step by step direction are below. Here is a setup walkthrough video made by G Factor:+Step by step direction are below. Here is a setup walkthrough video made by G Factor - a new video will be made soon (for the UI, it will auto update when opened as the screenshots on this page show below):
  
    
Line 82: Line 82:
 ===== Important Notes ===== ===== Important Notes =====
  
-1. Always tell QORTector to shut down the Qortal Core prior to turning off or rebooting the device to avoid corrupting the database: +1. Always tell QORTector to shut down the Qortal Core prior to turning off or rebooting the device to avoid corrupting the database. Below are the commands for you to be aware of, but not necessary for you to enter at this point in the guide: 
 + 
 +To shutdown the device in the terminal
  
 <code>sudo shutdown</code>  <code>sudo shutdown</code> 
  
-<code?sudo reboot</code>+To reboot the device in terminal: 
 + 
 +<code>sudo reboot</code>
  
 Do not use the power switch. Power switch should only be shut off after the device powers down to protect it from surges, but with that said, you should consider a surge protector or UPS (battery power supply) regardless as the QORTector is intended to stay running 24/7.  Do not use the power switch. Power switch should only be shut off after the device powers down to protect it from surges, but with that said, you should consider a surge protector or UPS (battery power supply) regardless as the QORTector is intended to stay running 24/7. 
  
-2. The QORTector is setup to automatically start the Qortal Core in the background. On the QORTector, you will not see the Qortal icon on the taskbar when you start the device.+2. The QORTector is setup to automatically start the Qortal Core in the background. On the QORTector, you will not see the Qortal icon on the system tray when you start the device. The device was configured this way so that the Qortal core will start whether the user connects a monitor or not. Simply stop the core, then start the core again, and the icon will display in the system tray. 
 + 
 +3. The QORTector must be setup for your specific country locale for wifi and timezone, if you wish to use wireless communications. Follow the instructions above in order to configure the device for your locale. The default setting for these devices is USA - Pacific Standard Time (so if you're in this timezone, then skip this step). 
 + 
 +4. Enter the command below to update all of the typical software components on your device (unrelated to Qortal). You can enter this command as frequently as you'd like to ensure your device is up to date:
  
-The device was configured this way so that the Qortal core will start whether the user connects a monitor or not, you CAN configure it to start with a .desktop file so that it will show the icon on the taskbar, and there is a script for that available on crowetic's github. https://github.com/crowetic/qortector-scripts - there is a .desktop file there with instructions. You can also ask in the Qortal telegram or Discord for assistance.+<code>sudo apt update && sudo apt -y upgrade</code>
  
-3. The QORTector must be setup for your specific country locale for wifi and timezone, if you wish to use wireless communicationsFollow the instructions above in order to configure the device for your locale. We will start configuring the devices for USA - Pacific Standard Time locale by default.+5. The HDMI cable must be connected BEFORE you power on the device, otherwise it will not display on the monitorIf you are disconnecting the HDMI cable for whatever reason, be sure to power off the device BEFORE you disconnect the cable
  
-4. If you have ANY issues whatsoever, please reach out in the Qortal Tech Support Official Telegram channel or Discord #qortector-pi-support channel! +6. If you have ANY issues whatsoever, please reach out in the Qortal Tech Support Official Telegram channel or Discord #qortector-pi-support channel! 
  
 ===== Start & Stop QORTector ===== ===== Start & Stop QORTector =====
Line 138: Line 146:
 ===== How To Update The Core and UI Versions ===== ===== How To Update The Core and UI Versions =====
  
-When your device arrives, you can let it sync and auto update the Core and UI if there was an update during shipment of your QORTector. You can also manually update the core and UI to expedite this process (which may be best or international orders that take longer to be delivered). Refer to the [[Qortal Status Updates]] page to check the latest Core and UI version. +When your device arrives, you can let it sync naturally and it will auto update the Core and UI if there was an update during shipment of your QORTector. You can also manually update the core and UI to expedite this process (which may be best or international orders that take longer to be delivered). Refer to the [[Qortal Status Updates]] page to check the latest Core and UI version. 
  
-To manually update the Core, open Terminal. Copy and paste this, then press the enter key:+To manually update the Core and database, open Terminal. Copy and paste this, then press the enter key (this will also delete the existing database “db” and bootstrap. A bootstrap is a download of a database that is updated every 12 hours so that you only have to sync the remaining blocks from the latest bootstrap creation. You will notice several 0-100% processes during the popup screen, then you will need to wait for it to finish synchronizing which will continue after the popup has closed:
  
-<code>cd && cd qortal && ./stop.sh && rm qortal.jar && rm -R db && curl -L -O https://github.com/Qortal/qortal/releases/latest/download/qortal.jar && ./start.sh</code>+<code>cd && cd qortal && rm qortal.jar && rm -R db && curl -L -O https://github.com/Qortal/qortal/releases/latest/download/qortal.jar && ./start.sh</code>
  
-To manually update the UI, open TerminalCopy and paste thisthen press the enter key:+To update the UI, open the UIIf there is an update availableyou'll see a notification like the screenshot below:
  
-<code>cd && cd Desktop && rm Start-Qortal* && wget https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-arm.AppImage && chmod +x Qortal-Set*.AppImage && mv Qortal-Set*.AppImage Qortal-UI</code>+{{::screenshot_at_2022-06-15_03-49-37.png?400|}}
  
 +Followed by the screenshot below, where you'll have the option to restart now or update upon closing the UI:
 +
 +{{::screenshot_at_2022-06-15_03-49-46.png?400|}}
 ===== How To Change The Search Engine & Browser ===== ===== How To Change The Search Engine & Browser =====
  
Line 182: Line 193:
 ===== Adjusting json Settings For Low Bandwidth ===== ===== Adjusting json Settings For Low Bandwidth =====
  
-For those who have low bandwidth internet service, you will want to reduce your peer settings in the json fileSimply change the minBlockchainPeers to 3, and the maxPeers to 16 as seen below (or just copy and paste the code below into your json file - replacing what is there currently): +Go to the [[How To Reduce Bandwidth]] page.
- +
-<code>+
-"apiDocumentationEnabled": true, +
-"apiEnabled": true, +
-"apiRestricted": false, +
-"autoUpdateEnabled": true, +
-"minBlockchainPeers": 3, +
-"minOutboundPeers": 16, +
-"maxPeers": 16, +
-"listenPort": 12392, +
-"allowConnectionsWithOlderPeerVersions": false +
-}</code>+
qortector_walkthrough.1650502457.txt.gz · Last modified: 04/20/2022 20:54 by gfactor