Vu Multiboot

From OpenPLi Wiki
Revision as of 15:53, 20 June 2024 by WanWizard (talk | contribs) (Rewritten kexec restore procedure)
Jump to: navigation, search

Intro

With OpenPLi 9 we offer multiboot for all Vu+ 4K receivers, so only the 4K versions!!! So it's a Vu+ 4K receiver specific feature that makes it possible to install multiple images on your Vu+ 4K receiver. When you have activated this feature, you can install multiple images, how much images you can install, when it is supported, depends on the slots, let's say the partitions that become present.
Below we will explain how to activate this feature.

Initialize Vu+ 4K Multiboot

By default Vu+ 4K Multiboot is not active, you have to activate or Initialize Multiboot. If you want multiboot, you go to Main menu > Setup > Flash image. Your receiver needs connection to the internet (never connect your receiver directly to internet! Always behind a firewall/Router). So if you receiver supports it, below in the screen you will see the option Initialize Multiboot (see below)

VuMultiboot-001.jpg

Now press the yellow button as pointed out in the picture above and the screen below will appear.

VuMultiboot-002.jpg

Now you have tree choices,

  • press Exit on your remote control and nothing is changed, so no multiboot,
  • Press the Green button and you will Init Multiboot, as shown in the picture below, please wait until your receiver reboots.
VuMultiboot-003.jpg
  • Press the Red button to completely remove the Multiboot option. when you do the screen below will appear.
VuMultiboot-004.jpg

Pressed the Remove forever (as you can see above) you can still abort removing the Multiboot by selecting No with your remote control. If you have pressed Yes and removed multiboot, please restart/reboot and after a restart the option "Initialize Multiboot" will be gone (see below).

VuMultiboot-005.jpg

Remove forever


Remove forever will of course only remove the multiboot feature from this particular image, so if you reconsider and want multiboot back, a flash will return the Multiboot feature. Remove forever will not be saved in your autobackup.

Adding other OpenPLi versions or other images

When you have multiboot you can install an image in every free slot (= partitions where you can install an image). In each slot you can install an OpenPLi version and there is the option to install OpenPLI with or without a backup. of course you can always install other images.

AutoBackup

When you flash a multi boot version from the menu a backup is created and restored by default. When this flash process starts there is a time window to cancel it, so by default a backup is created from the current image and will be restored right after the flash on the newly installed image. In most cases and certainly when there is no HDD present, a USB stick with enough space, has to be plugged into the receiver so create the backup. These backup files are relatively small. In many cases it is best to use a USB stick of about 1 Gb, albeit to store the downloaded image.

How to select an installed multiboot image

There are 2 ways to select the image to boot from. Using the remote control you simply press Menu and go into Standby/Restart menu. Press long on the power control button using your remote control a menu appears and as you can see in the picture below there is the "Multiboot image selector" option, once pressed it offers the images you have installed.

VuMultiboot-006.jpg

Now you can pick one and OpenPLi will boot into it. In the picture below only 1 is showed, as this is the one created after you initialized Multiboot. When you install more images these will also be displayed.

VuMultiboot-007.jpg


When there are more images installed there is also the possibility by pressing yellow button to remove an image. See picture below.

VuMultiboot-008.jpg

Once you remove an image, the yellow button changes to restore deleted images, in case you made a mistake. Even when you reboot you can restore deleted images, once you install a new one it the "old slot" it will be gone!

Adding other images than OpenPLi

If you want to add any other images, well other than OpenPLi, you can also flash them using the other images button, see pictures below. This will open the option to choose other brands.

VuMultiboot-009.jpg


VuMultiboot-010.jpg

Forced loading recovery image

The first image, the one in which you activated multi boot is called "the recovery image" is in slot 0. If you for some reason, you want to boot not from the menu using the multiboot image selector (see pictures above), then create an empty STARTUP_RECOVERY file at the root of you HHD/USB drive and hold de Power button for more than 12 seconds for reboot receiver.

Multiboot images missing after an update?

Under specific circumstances, it is possible to break the VU+ Kexec multiboot. This happens when the update contains a new kernel-image package, which gets installed in flash instead of in the current multiboot slot, if the image isn't built multiboot aware. When this happens, the box will reboot into slot 0 (the original images flashed), the multiboot images will be gone, and Enigma will crash if you attempt to reinstall or reactivate multiboot.

However, not all is lost, and with a bit of commandline magic, you can restore the multiboot functionality without loss of data.

Before you start

It is recommended to make backups of your multiboot slots first, before you start restoring the multiboot kernel. This way, if the box won't boot after attempting the restore, you can always fall back to flashing the box via USB, install and activate multiboot again, and then restore your backups.

To make this backup, you need access to the commandline, so login using SSH or telnet. Then execute the following commands:

  • tar -cvzf /media/hdd/linuxrootfs1.tar.gz /linuxrootfs1 (for slot 1)
  • tar -cvzf /media/hdd/linuxrootfs1.tar.gz /linuxrootfs2 (for slot 2)
  • tar -cvzf /media/hdd/linuxrootfs1.tar.gz /linuxrootfs3 (for slot 3)

( if you don't want to use or don't have a local disk, change /media/hdd in these commands to your desired storage location. You need about 4GB of free space )

Reinstall the kexec multiboot kernel

Follow these steps, once you've booted slot 0, and logged in:

  • execute the following command: opkg install vuplus-kexec --force-reinstall
  • for the VU+ Zero 4K, execute the following command: dd if=/usr/bin/kernel_auto.bin of=/dev/mmcblk0p4
  • for the VU+ Solo 4K, execute the following command: dd if=/usr/bin/kernel_auto.bin of=/dev/mmcblk0p1
  • for the VU+ Uno 4K, execute the following command: dd if=/usr/bin/kernel_auto.bin of=/dev/mmcblk0p1
  • for the VU+ Duo 4K, execute the following command: dd if=/usr/bin/kernel_auto.bin of=/dev/mmcblk0p6
  • for the VU+ Ultimo 4K, execute the following command: dd if=/usr/bin/kernel_auto.bin of=/dev/mmcblk0p1
  • for the VU+ Uno 4K SE, execute the following command: dd if=/usr/bin/kernel_auto.bin of=/dev/mmcblk0p1
  • for the VU+ Duo 4K SE, execute the following command: dd if=/usr/bin/kernel_auto.bin of=/dev/mmcblk0p6
  • execute the following command: mv /usr/bin/STARTUP.cpio.gz /STARTUP.cpio.gz
  • reboot

Plan B

If the above doesn't give you a working box back, with all our multiboot slots exactly as they were, it is time for plan B.

If you followed the recommendation and made a backup first, that is. If you did, follow these steps:

  • reflash the STB via USB, with the image you want to be used as slot 0. We advise to use OpenPLi, as it is one of the smallest available.
  • after the image boots up, install and activate multiboot again. The box will restart after this.
  • use telnet to connect (SSH won't work on newly flashed images without password), and restore your backups:
  • tar -xvzf /media/hdd/linuxrootfs1.tar.gz -C / (for slot 1)
  • tar -xvzf /media/hdd/linuxrootfs2.tar.gz -C / (for slot 2)
  • tar -xvzf /media/hdd/linuxrootfs3.tar.gz -C / (for slot 3)
  • reboot

The box should now restart the image in slot 0, and your multiboot slots should be available for selection again.

NB: Be VERY careful when typing in these commands. A simple typo can spell disaster and may result in you having to start from scratch again, with the loss of your multiboot slots. It is advised to use copy/paste to make sure you don't make any mistakes while typing.