Differences

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

--- upgrade_manually [2022/05/11 14:16] – reorder unzipping atari
+++ upgrade_manually [2023/11/18 23:56] (current) – [Upgrading/downgrading Batocera] Adjust wording, fix typos maximumentropy
@@ Line 17: / Line 17: @@
 ===== Upgrading/downgrading Batocera =====
-In Batocera **5.23** and higher, it is advised to upgrade/downgrade using the ''batocera-upgrade'' command [[access_the_batocera_via_ssh|via SSH]]. Grab the [[:current_and_previous_releases|URL]] of the version you want to upgrade/downgrade to and run ''%%batocera-upgrade [URL]%%''. For example, to upgrade to the latest stable for x86_64:
+In Batocera **5.23** and higher, it is advised to upgrade/downgrade using the ''batocera-upgrade'' command [[access_the_batocera_via_ssh|via SSH]]. Grab the [[:current_and_previous_releases|URL of the version you want]] to upgrade/downgrade to and run ''%%batocera-upgrade [URL]%%''. For example, to upgrade to the latest stable for x86_64:
 <code>
 batocera-upgrade https://batocera.org/upgrades/x86_64/stable/last
 </code>
+Or to downgrade to a specific [[:current_and_previous_releases#current_builds_older_releases_and_betas|older version]], like in the example below to downgrade to Batocera 36 for PC x86_64. Don't copy that command on another architecture like a Raspberry Pi, you need to adapt the URL to it.
+<code>
+batocera-upgrade https://mirrors.o2switch.fr/batocera/x86_64/stable/last/archives/36/
+</code>
+<WRAP center round info 60%>
+The command ''%%cat /boot/boot/batocera.board%%'' can be used to display the arch that should be used.  For example, on a PC this will display x86_64.
+</WRAP>
 You should then see output similar to this:
@@ Line 29: / Line 40: @@
 url: https://updates.batocera.org/x86_64/stable/last/boot.tar.xz
 need to download 1876mb
-m/upgrade/boot.tar.xz     0%[                              ]   9.55M  1.82MB/s    eta 19m 42s
+/userdata/system/upgrade/boot.tar.xz     0%[                              ]   9.55M  1.82MB/s    eta 19m 42s
 </code>
-For Batocera 5.**7** to 5.**22**, the command (for PC x86_64, please adapt to the right architecture) would instead be:
+For very old versions, from Batocera 5.**7** to 5.**22**, the command (for PC x86_64, please adapt to the right architecture) would instead be:
 <code>
@@ Line 46: / Line 57: @@
 To upgrade/downgrade manually from a downloaded ''boot.tar.xz'' file:
   - Download the ''boot.tar.xz'' file of the version you want. The official ones are available at https://mirrors.o2switch.fr/batocera/ (for older versions, navigate to your architecture and go to /stable/last/archives/). [[:current_and_previous_releases#current_builds|Here's a list of architectures and links to their builds.]]
-  - Backup your boot configuration files from the Batocera machine (if you have edited them and require the edits to boot properly) to a safe location.
+  - Backup your boot configuration files (''batocera-boot.conf'' and ''config.txt'') from the Batocera machine (if you have edited them and require the edits to boot properly) to a safe location.
   - Unzip the ''boot.tar.xz'' file (it's just like a ''.zip'', you can use 7-zip on Windows) to get the ''boot.tar'' file.
   - Unzip the ''boot.tar'' file into the root of your Batocera drive's [[:edit_boot_partition|boot partition]] (this is the default partition you see when inserting the drive into Windows) and overwrite the existing files. You may have to [[:edit_boot_partition#plugging_it_into_another_machine|assign a drive letter under Windows Disk Management]] to see it in the file explorer.
@@ Line 57: / Line 68: @@
   - Check the md5sum of the file to ensure that it was downloaded correctly (this may take a bit of time, depending on the speed of your drive)
   - After validation, remount the boot partition in rewritable mode
-  - Back up your boot config files
+  - Back up your boot config files: ''/boot/batocera-boot.conf'' to ''/boot/batocera-boot.conf.upgrade'' and ''/boot/config.txt'' to ''/boot/config.txt.upgrade''
   - Unzip the contents of ''/userdata/system/upgrade/boot.tar.xz'' to ''/boot/''
-  - Restore your boot config files
+  - Restore your boot config files: ''/boot/batocera-boot.conf.upgrade'' to ''/boot/batocera-boot.conf'' and ''/boot/config.txt.upgrade'' to ''/boot/config.txt''
   - Do a "final cleanup"
   - Remove ''/userdata/system/upgrade/boot.tar.xz''
@@ Line 73: / Line 84: @@
 To work around there not being enough free space in the **userdata** partition, you can do any of the following:
   * Temporarily remove some of your ROMs, BIOS, and other userdata to make enough free space to download the ''boot.tar.xz'' file.
-  * Download the ''boot.tar.xz'' from [[:current_and_previous_releases#current_builds|the server]] for the intended Batocera version onto another computer, connect the Batocera drive to it, and extract the contents of ''boot.tar.xz'' directly to the boot partition of Batocera.
+  * Download the ''boot.tar.xz'' from [[:current_and_previous_releases#current_builds|the server]] for the intended Batocera version onto another computer, connect the Batocera drive to it, and extract the contents of ''boot.tar'' directly to the boot partition of Batocera.
 ==== Boot partition ====
@@ Line 91: / Line 102: @@
     - Back up the contents of the FAT32 boot partition of the Batocera drive (Windows should only be able to see this partition and nothing else by default) to another location
     - Delete the ''/boot/batocera'' file from the Batocera drive (it is just called ''batocera'' without a file-extension and is about 2 GB large (smaller in older versions))
-    - Extract the ''boot.tar.xz'' file to the root of that partition
+    - Extract the ''boot.tar'' file to the root of that partition
     - Replug the Batocera back into your Batocera machine and boot Batocera. <WRAP center round tip>
 If Batocera fails to boot, you can restore the data you backed up in step 2.