Differences

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

--- qortector_update_guide [04/20/2022 20:55] – gfactor
+++ qortector_update_guide [05/22/2023 14:05] (current) – quickmythril
@@ Line 2: / Line 2: @@
 {{:qortal_official_logo_transparent_.png?400|}}
-This is a guide for updating the QORTector. **Please note:** there are three versions of the QORTector which are Plumbus, SinclairMATE, and Titan.
+This is a guide for updating the QORTector.
-) Download the appimage if you haven’t already: https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-arm.AppImage
+===== How To Update The Core=====
-**For SinclairMATE Versions**
+This will remove all the log files, download the newest version of the qortal.jar:
-Simply download the file (rename it if you like, something like 'Qortal-UI' makes the most sense). Right click the file and go to properties, on the properties window there is a permissions tab, on that tab check the 'execute' box for 'owner' (see image below) then you can simply double-click and RUN the appimage, no longer needing to build from source.
+<code>cd && cd qortal && ./stop.sh && rm qortal.jar && curl -L -O https://github.com/Qortal/qortal/releases/latest/download/qortal.jar && ./start.sh</code>
-{{:properties-security-execute.png?400|}}
+===== How To Update The DB & Bootstrap =====
-**For Plumbus Versions and TitanMATE**
+Go to the [[How To Bootstrap & Delete The DB]] page.
-Simply download the file (rename it if you like, something like 'Qortal-UI' makes the most sense). Right click the file, properties, then go to permissions and check the allow executing this file as a program checkbox.
+===== How To Update Core & Bootstrap In One Command =====
-{{::6597da57-0885-4c81-8dd8-ebede74623af.png?400|}}
+If you’d like, you can simply replace the core and db (to bootstrap) all in one command. 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::
-**For Both SinclairMATE & Plumbus Versions**
+<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>
-When using the appimage you NO LONGER NEED the previous start script that you used to use to start the UI, you can REMOVE that start script. **Please note:** building from source will also continue to work, and you may build from source if you prefer. We have modified the repo that the UI uses, so you will need to update the update script if you want to continue building from source. (HFactor has built a new script repo here https://github.com/xspektrex/QORTectorScripts)
+===== How To Update The UI =====
-You can add the Qortal icon to the appimage file - by right clicking on the appimage file, going to properties then clicking the icon, it will open up a browse, and you can find the Qortal UI icon in the ```UI/qortal-ui/img``` folder, select that icon, and click OK, then the appimage file will have the Qortal UI icon on it, and will look just like the previous start script looked.
+To update the UI, open the UI. If there is an update available, you'll see a notification like the screenshot below:
-(This is mostly for QORTector users, or anyone who setup their system in a similar fashion, with the Start-Qortal-UI-Electron.sh script that @crowetic wrote. That script, as well as the update script, are no longer needed if you use the new appimage. The appimage is literally an image of the Qortal UI application, it is the ONLY file you need. Simply make it executable and run it, you no longer need the from source build stuff, start script, etc.)
+{{::screenshot_at_2022-06-15_03-49-37.png?400|}}
-To re-iterate and avoid confusion - You do NOT need the previous 'Start-Qortal-UI.sh' script anymore, and you do not need the 'yarn run server' done in the terminal anymore, IF you are SWITCHING to using the .appimage version.
+Followed by the screenshot below, where you'll have the option to restart now or update upon closing the UI:
-You run the appimage file directly, after making it executable.
+{{::screenshot_at_2022-06-15_03-49-46.png?400|}}
-) Enter this command in terminal to update the stop script if you haven’t already:
+===== Port Forwarding =====
-<code>cd qortal && rm stop.sh && wget https://raw.githubusercontent.com/Qortal/qortal/master/stop.sh && chmod +x stop.sh</code>
+If you have admin access to your router, you should configure port forwarding for the QORTector. Refer to the [[Port Forwarding]] page on how to do so.
-) Now stop your core and download the latest jar, remove db and apikey.txt, and start qortal again:
+===== Adjusting json Settings For Low Bandwidth =====
-<code>cd && cd qortal && rm qortal.jar && wget https://github.com/Qortal/qortal/releases/latest/download/qortal.jar && rm -R db && rm apikey.txt && ./start.sh</code>
+Go to the [[How To Reduce Bandwidth]] page.
-)(**optional**) Now if you would like to modify the settings to the recommended defaults, open the **settings.json**
-Your settings will look blank, which will have the default settings, you do not HAVE to modify your settings if everything is working alright for you, however, if you'd like you can copy the settings below into your file. Remember, every line has a comma after it except the last line, and there are brackets at the beginning and end.
-<code>{
-"apiDocumentationEnabled": true,
-"apiEnabled": true,
-"apiRestricted": false,
-"autoUpdateEnabled": true,
-"minBlockchainPeers": 8,
-"minOutboundPeers": 16,
-"maxPeers": 32,
-"listenPort": 12392,
-"allowConnectionsWithOlderPeerVersions": false
-}</code>
-{{::e1c92d55-bf13-4c70-98f3-b2075471b3b9.jpeg?400|}}
-{{::8f077e91-5a12-4002-a4b1-a0886c2d6731.jpeg?400|}}
-**BE AWARE - if your node is in the middle of bootstrapping, LET IT FINISH FIRST, before restarting the core.**
-)(**if you modified settings.json**) If you modified the settings.json, you will need to restart your core for the new settings to take effect. <code> cd && cd qortal && ./stop.sh && ./start.sh</code>
-) If you have access to your router, and you would like to setup incoming connections (port forwarding) you can allow port 12392 (default p2p port for Qortal) into your node's LAN IP.
-Inbound and outbound to: 12392
-Protocol: TCP
-Here’s the guide for port forwarding (especially important if you have more than one node): [[Port Forwarding]]
-If you are setting port forwarding, you might need to restart the router after doing so (depending on the router). Usually the router has a "save and apply" button or something, and restarts itself. Some of your routers won’t. Some routers may simply apply the setting without needing a restart as well. Your router setup might look different than the picture below but same idea:
-{{::1a4a9d05-ee00-477b-b78d-eb67f5aa7629.jpeg?400|}}
-**Please note:** When you start the core either for the first time, or after deleting the db,  it’ll bootstrap automatically with a splash screen that will pop up, let it run its course. May take an hour or so (depending on your internet connection speed, it will take anywhere from 20 minutes to over an hour).

Qortal Project

User Tools

Site Tools

Differences

Page Tools