#1 Global Leader in Data Protection & Ransomware Recovery

Veeam Recovery Media for Linux OS, Workarounds

KB ID: 4183
Product: Veeam Agent for Linux | 5.0 | 6.0 | 6.1
Published: 2021-06-17
Last Modified: 2023-07-20
mailbox
Get weekly article updates
By subscribing, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.

Cheers for trusting us with the spot in your mailbox!

Now you’re less likely to miss what’s been brewing in our knowledge base with this weekly digest

error icon

Oops! Something went wrong.

Please try again later.

This article documents rare issues that may be experienced when using the Veeam Recovery Media for Linux OSs and workarounds for them.
Veeam Recovery Media fails to boot from a USB flash drive created with third-party ISO flashing software.

Challenge

A Linux machine cannot boot the Veeam Recovery Media from a USB flash drive created using a third-party tool to image the ISO onto the USB flash drive. 

Cause

Third-party ISO-to-USB imaging software may alter the way the image boots when writing the ISO contents to the flash drive.

Workaround

Write the ISO image to the USB flash drive using the dd command-line program.

Example:

sudo dd bs=4M if=/path/to/veeam-recovery.iso of=/dev/sdx status=progress oflag=sync
The if and of parameters in the command above will need to be adjusted for the environment.
Some hardware is not recognized in the Veeam Recovery Media or you are unable to patch Veeam Recovery Media.

Challenge

Hardware is not recognized in the Veeam Recovery Media environment, and any of the following are also true:

  • Using Custom Veeam Recovery Media also fails to recognize the hardware.
  • Linux kernel in use was version 3.10 or older.
  • Your distribution is SLES 15 SP4 or 15 SP5, OpenSUSE 15.4 or 15.5, or OpenSUSE Tumbleweed.
     

Workaround

  1. Create and boot into a Live CD of the Linux distro that is compatible with the hardware.
  2. Install Veeam Agent for Linux inside this Live CD environment. 
    Note: The veeamsnap kernel module is not required for restores, so to avoid installing kernel-headers, you may either install veeam-nosnap package or install the veeam package with broken veeamsnap dependency.
  3. Enable recovery UI by adding the following line to /etc/veeam/veeam.ini under the [recoveryui] section
enableOnLiveSystem = 1
  1. Restart the veeamservice to apply changes:
sudo service veeamservice restart
  1. Open Recovery UI using the command:
veeamconfig recoveryui
Patched Custom Veeam Recovery ISO does not start veeamservice on boot

Challenge

When booting from a recovery media image patched on specific Linux kernels, veeamservice does not start correctly. As a result, the recovery UI is inaccessible. The following output is displayed instead:

Linux veeam-recovery-iso 4.18.0-240.22.1.e18_3.x86_64 #1 SMP Thu Mar 25 14:36:04 EDT 2021 X86_64
Welcome to Veeam Agent for Linux Recovery Media.
To open Veeam Recovery UI execute 'sudo veeam'.
No such file or directory
Failed to connect: /var/tmp/veeam/socket/veeamservice.sock.
Failed to connect to veeamservice daemon.
To open Veeam Recovery UI execute 'sudo veeam'.
veeamservice start at boot failure

Cause

This is related to a squashfs bug 1/2/3 in Linux kernel 5.9, which appears in the Enterprise Linux distributions: RHEL 8.3 and specific versions of Oracle Linux. 

Workaround

To access the recovery UI, reboot and press TAB in the Boot menu of the Recovery Media. Add " selinux=0" to the end of the kernel command line and press Enter to finish the boot process.

selinux setting
Veeam Recovery Media interface doesn't fit within the screen borders.

Challenge

Veeam Recovery Media interface doesn't fit within the screen borders.

Cause

The screen has a high resolution (1920x1080 and above). Veeam Recovery Media interface screen resolution is 1024x768 by default. This is related to the default video parameter in /boot/grub/grub.cfg:

menuentry "Veeam Recovery 4.19.0-17-amd64" {
linux /vmlinuz-4.19.0-17-amd64 usbcore.autosuspend=-1 vga=773 video=1024x768 boot=veeam-live
initrd /initrd.img-4.19.0-17-amd64
}

Workaround

Reboot and press TAB in the Boot menu of the Recovery Media. Change the video parameter to the native display resolution and press Enter to finish the boot process.

Corrected video parameter 1920x1080
To submit feedback regarding this article, please click this link: Send Article Feedback
To report a typo on this page, highlight the typo with your mouse and press CTRL + Enter.

Spelling error in text

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

Oops! Something went wrong.

Please try again later.

You have selected too large block!

Please try select less.

KB Feedback/Suggestion

This form is only for KB Feedback/Suggestions, if you need help with the software open a support case

By submitting, you are agreeing to have your personal information managed in accordance with the terms of Veeam's Privacy Notice.
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
Verify your email to continue your product download
We've sent a verification code to:
  • Incorrect verification code. Please try again.
An email with a verification code was just sent to
Didn't receive the code? Click to resend in sec
Didn't receive the code? Click to resend
Thank you!

Thank you!

Your feedback has been received and will be reviewed.

error icon

Oops! Something went wrong.

Please try again later.