From 3f965fd21be3c26ef7ff8a524afcb05be04dc187 Mon Sep 17 00:00:00 2001 From: Griffin Date: Thu, 3 Oct 2024 14:04:26 -0700 Subject: [PATCH 1/2] add basic documentation for opensuse --- guest-support/linux.md | 18 ++++++++++++ guides/opensuse.md | 62 ++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 80 insertions(+) create mode 100644 guides/opensuse.md diff --git a/guest-support/linux.md b/guest-support/linux.md index f9d483c..c584124 100644 --- a/guest-support/linux.md +++ b/guest-support/linux.md @@ -37,6 +37,12 @@ $ sudo apt install spice-vdagent $ sudo yum install spice-vdagent ``` +### openSUSE + +``` +$ sudo zypper install spice-vdagent +``` + {: .note } These systems will typically already have SPICE agent installed. @@ -61,6 +67,12 @@ $ sudo apt install qemu-guest-agent $ sudo yum install qemu-guest-agent ``` +### openSUSE + +``` +$ sudo zypper install qemu-guest-agent +``` + ### ArchLinux ``` @@ -86,6 +98,12 @@ $ sudo apt install spice-webdavd $ sudo yum install spice-webdavd ``` +### openSUSE + +``` +$ sudo zypper install spice-webdavd +``` + ### ArchLinux ``` diff --git a/guides/opensuse.md b/guides/opensuse.md new file mode 100644 index 0000000..1f0885c --- /dev/null +++ b/guides/opensuse.md @@ -0,0 +1,62 @@ +--- +layout: default +title: openSUSE +parent: Guides +--- +{: .label .label-green } +**macOS** + +{% include toc.md %} + +## Downloads + +* [openSUSE Tumbleweed](https://get.opensuse.org/tumbleweed/) +* [openSUSE Leap](https://get.opensuse.org/leap) +* [openSUSE MicroOS](https://get.opensuse.org/microos/#download) +* [openSUSE Leap Micro](https://get.opensuse.org/leapmicro) + + +## Creating a new virtual machine + +1. Open UTM and click the "+" button to open the VM creation wizard. +2. Select "Virtualize". +3. Select "Linux". +4. Click "Browse" and select the openSUSE ISO downloaded from the links above. Press "Continue" to continue. +5. Pick the amount of RAM and CPU cores you wish to give access to the VM. Press "Continue" to continue. +6. Specify the maximum amount of drive space to allocate. Press "Continue" to continue. +6. If you have a directory you want to mount in the VM, you can select it here. Alternatively, you can skip this and select the directory later from the VM window's toolbar. The shared directory will be available after installing SPICE tools (see below). Press "Continue" to continue. +8. Press "Save" to create the VM and press the Run button to start the VM. +9. Go through the Ubuntu installer. If the reboot fails, you can manually quit the VM, unmount the installer ISO, and start the VM again to boot into your new installation. + +## Installing Ubuntu Desktop + +If you installed Ubuntu Server, then at the end of the installation, you will not have any GUI. To install Ubuntu Desktop, log in and run: + +``` +$ sudo apt update +$ sudo apt install ubuntu-desktop +$ sudo reboot +``` + +## Enable clipboard and directory sharing + +[Follow the instructions in this page.]({% link guest-support/linux.md %}) + +## Troubleshooting + +### Cannot boot into installer + +If you start the VM and are stuck at the EFI screen (`BdsDxe: failed to load Boot0001` or `UEFI Interactive Shell`), try the following in order. + +1. Make sure you have the installer ISO selected. Click the disk icon on the toolbar and check that there is a menu option for `CD/DVD (ISO) Image (usb): ubuntu-xxx.iso`. If it says `CD/DVD (ISO) Image (usb): none`, then highlight that menu and choose `Change` and then select the ISO. If you don't have any selectable menu option, follow the guide again and make sure you have added a removable drive. Then restart the VM. +2. Next, try to get into the EFI Shell. If you see `UEFI Interactive Shell` then you are already in the shell. Otherwise, restart the VM and quickly press the Esc key to enter the shell. +3. In the EFI shell make sure you see `FS0: Alias(s):CD0h0a0a::BLK1:` near the top or something similar. If not, then double check your configuration and make sure you have a removable drive configured and the installer ISO mounted. Also check that your ISO is valid. +4. Type in: `fs0:\efi\boot\bootaa64.efi` and you should see GRUB. Then select `Ubuntu Server` to continue with the install. + +### Networking is unavailable + +If the hardware enumeration order changes, your network settings may need to be updated. + +1. Run `ip link show` and look at the last adapter name. For example, it may be listed as `enp0s1`. +2. Edit `/etc/netplan/00-installer-config.yaml` and copy your configuration for `enp0s8` (or whatever the old adapter was named) and paste it immediately after for `enp0s1` (or whatever the new adapter is named). +3. Reboot and you should be able to use networking again. From ac115cee7fde3f4edaaa94e02edfe1aedde42e09 Mon Sep 17 00:00:00 2001 From: Griffin Date: Thu, 3 Oct 2024 14:37:47 -0700 Subject: [PATCH 2/2] fix broken edits --- guides/opensuse.md | 29 ++++------------------------- 1 file changed, 4 insertions(+), 25 deletions(-) diff --git a/guides/opensuse.md b/guides/opensuse.md index 1f0885c..92d551e 100644 --- a/guides/opensuse.md +++ b/guides/opensuse.md @@ -28,35 +28,14 @@ parent: Guides 8. Press "Save" to create the VM and press the Run button to start the VM. 9. Go through the Ubuntu installer. If the reboot fails, you can manually quit the VM, unmount the installer ISO, and start the VM again to boot into your new installation. -## Installing Ubuntu Desktop +## Finishing Installation -If you installed Ubuntu Server, then at the end of the installation, you will not have any GUI. To install Ubuntu Desktop, log in and run: +For the most part, everything should be up to date and running depending on your version. That said, it is always smart to ensure things are updated [using YaST](https://en.opensuse.org/YaST_Online_Update) or by running -``` -$ sudo apt update -$ sudo apt install ubuntu-desktop -$ sudo reboot +```sh +sudo zypper up ``` ## Enable clipboard and directory sharing [Follow the instructions in this page.]({% link guest-support/linux.md %}) - -## Troubleshooting - -### Cannot boot into installer - -If you start the VM and are stuck at the EFI screen (`BdsDxe: failed to load Boot0001` or `UEFI Interactive Shell`), try the following in order. - -1. Make sure you have the installer ISO selected. Click the disk icon on the toolbar and check that there is a menu option for `CD/DVD (ISO) Image (usb): ubuntu-xxx.iso`. If it says `CD/DVD (ISO) Image (usb): none`, then highlight that menu and choose `Change` and then select the ISO. If you don't have any selectable menu option, follow the guide again and make sure you have added a removable drive. Then restart the VM. -2. Next, try to get into the EFI Shell. If you see `UEFI Interactive Shell` then you are already in the shell. Otherwise, restart the VM and quickly press the Esc key to enter the shell. -3. In the EFI shell make sure you see `FS0: Alias(s):CD0h0a0a::BLK1:` near the top or something similar. If not, then double check your configuration and make sure you have a removable drive configured and the installer ISO mounted. Also check that your ISO is valid. -4. Type in: `fs0:\efi\boot\bootaa64.efi` and you should see GRUB. Then select `Ubuntu Server` to continue with the install. - -### Networking is unavailable - -If the hardware enumeration order changes, your network settings may need to be updated. - -1. Run `ip link show` and look at the last adapter name. For example, it may be listed as `enp0s1`. -2. Edit `/etc/netplan/00-installer-config.yaml` and copy your configuration for `enp0s8` (or whatever the old adapter was named) and paste it immediately after for `enp0s1` (or whatever the new adapter is named). -3. Reboot and you should be able to use networking again.