Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
upgrade_manually [2020/09/17 17:01] joinskiupgrade_manually [2021/04/03 15:47] joinski
Line 1: Line 1:
-~~NOTOC~~ +====== Manual upgrades/downgrades ======
-===== Manual upgrades/downgrades =====+
 Upgrades/Downgrades can be done manually : Upgrades/Downgrades can be done manually :
   * in case you want to reinstall a previous version   * in case you want to reinstall a previous version
Line 7: Line 6:
  
 To upgrade/downgrade manually : To upgrade/downgrade manually :
-  - download the file boot.tar.xz of the version you want. The official ones are available here : http://batocera.org/upgrades +  - download the file boot.tar.xz of the version you want. The official ones are available here : http://batocera.org/upgrades (for older versions use https://mirrors.o2switch.fr/batocera/ and navigate to your architecture, then go to /stable/last/archives/) 
-  - a ''.tar.xz'' file is an archive format, like a ''.zip''. Just unzip this file onto your SD card/USB key to replace existing files.+  - a ''.tar.xz'' file is an archive format, like a ''.zip''. Just unzip this file onto your SD card/USB key/s ''BATOCERA'' partition((This partition is readeable on windows regardless of the filesystem you have chosen for the SHARE. You may have to assign a drive letter under Windows Disk Management, to see it in the file explorer)) to replace existing files.
  
 Or, starting with batocera.linux 5.23: Or, starting with batocera.linux 5.23:
-  - [[access_the_batocera_via_ssh|from SSH]], adapt the url to the right architecture and run : ''batocera-upgrade https://batocera.org/upgrades/x86_64/stable/last'' (this example is for PC x86_64, please adapt the URL to the right architecture)+  - [[access_the_batocera_via_ssh|from SSH]], adapt the url to the right architecture and run : ''%%batocera-upgrade https://batocera.org/upgrades/x86_64/stable/last%%'' (this example is for PC x86_64, please adapt the URL to the right architecture)
  
 For batocera.linux 5.7 to 5.22: For batocera.linux 5.7 to 5.22:
-  - [[access_the_batocera_via_ssh|from SSH]], the command line would be: ''/recalbox/scripts/recalbox-upgrade.sh https://batocera.org/upgrades/x86_64/stable/last'' (for PC x86_64, please adapt to the right architecture)+  - [[access_the_batocera_via_ssh|from SSH]], the command line would be: ''%%/recalbox/scripts/recalbox-upgrade.sh https://batocera.org/upgrades/x86_64/stable/last%%'' (for PC x86_64, please adapt to the right architecture)
  
 These commands upgrade -- or potentially downgrade -- the Batocera system. Upgrading or downgrading //doesn't remove// any of your user data (ROMs, metadata...). Like never, ever. These commands upgrade -- or potentially downgrade -- the Batocera system. Upgrading or downgrading //doesn't remove// any of your user data (ROMs, metadata...). Like never, ever.
  
-==== Error messages when upgrading ====+===== Error messages when upgrading =====
  
 If you get an error message telling you that you don't have enough space on your Batocera system partition when you upgrade, there might be several explanations.  If you get an error message telling you that you don't have enough space on your Batocera system partition when you upgrade, there might be several explanations. 
Line 24: Line 23:
 One of them is that you have [[splash_boot|stored several splash boot video files]] on the ''/boot'' partition. Remove them, and try to upgrade again.  One of them is that you have [[splash_boot|stored several splash boot video files]] on the ''/boot'' partition. Remove them, and try to upgrade again. 
  
 +The other explanation: Your first installation was an older version, where the boot-partition was smaller (in newer versions of batocera the space had to be rised because of more features).
 +In this case, you could either delete the "batocera"-file (it is just called batocera, without a file-extension, is about 1gb big and is located in the boot folder of the first/boot partition).
 +After that, extract the boot.tar.xz file onto that drive and if successfull, rename the file "batocera-update" located in the boot folder to just "batocera").
 +But be aware, that you would have to do this manual workaround (update-procedure) every time, you want to update to a new version.
  
-==== The batocera.linux usb key ==== +So it may be better, to backup all the files from your share-partition (roms, saves, bios, etc.) and start a fresh new install, by flashing the .img.gz file with for example balenaEtcher onto the drive, where you want to have batocera installed, then boot from it and copy back all roms, saves etc. to the share-partition of this new installation of batocera. 
-{{system:usbkey.png?700|}}+===== The batocera.linux usb key ===== 
 +{{system:usbkey.png?700|An illustration showing how the batocera system is laid out on a USB stick: the BATOCERA partition first, containing all the programs, and then the SHARE, containing all the userdata}}
  • upgrade_manually.txt
  • Last modified: 4 months ago
  • by maximumentropy