From b5e4cb235d9a337378beb48b1ec5ed7e4f1668ce Mon Sep 17 00:00:00 2001 From: Anthony Perkins Date: Sat, 18 Mar 2023 19:55:54 +0000 Subject: [PATCH] Convert docs to HTML --- docs/VirtInstall.html | 63 +++++++++++++++++++++++++++++++++++++++++++ docs/VirtInstall.txt | 61 ----------------------------------------- 2 files changed, 63 insertions(+), 61 deletions(-) create mode 100644 docs/VirtInstall.html delete mode 100644 docs/VirtInstall.txt diff --git a/docs/VirtInstall.html b/docs/VirtInstall.html new file mode 100644 index 0000000..1c51bce --- /dev/null +++ b/docs/VirtInstall.html @@ -0,0 +1,63 @@ + + + + + Building a VM with virt-install + + + +

Building a VM with virt-install

+ +

Introduction

+ +

This assumes that the network will be used in macvtap mode. + This is the preferred method, as it is faster than a regular bridge and does not need any additional network configuration on the host.

+ +

The disadvantage of macvtap is that host-to-vm and vm-to-host communication is blocked. + This can be worked around with an internal switch, or by having the macvtap connection bind to a second interface.

+ + +

Creating the VM

+ +

The following command assumes the machine type is linux2020 and the network card is eno1. + It should be run as the root user or with sudo, and should be run inside tmux for safety.

+ + 
virt-install --name rhel9                                        \
+   --osinfo linux2020                                            \
+   --boot uefi                                                   \
+   --cdrom /var/lib/libvirt/isos/rhel-baseos-9.1-x86_64-dvd.iso  \
+   --disk /var/lib/libvirt/images/rhel9.qcow2,size=20            \
+   --network type=direct,source=enp2s0,source_mode=bridge        \
+   --graphics vnc                                                \
+   --console pty,target.type=virtio                              \
+   --autoconsole none
+ +

Highlighted paths and names should be changed as appropriate. + The VNC port can be found for this example by running virsh vncdisplay rhel9.

+ + +

Alternative install options

+ +

Import a template image by copying the template into place and replacing --cdrom /path/to/disc.iso with --import. + The file size is not needed in the --disk option in this case.

+ +

PXE-boot a VM by replacing the --cdrom /path/to/disc.iso option with --pxe.

+ + +

Tips

+ +

For a virtio network card on Windows machines, add model=virtio to the --network option.

+ +

Other useful options are --memory 4096 for 4 GB RAM, and --vcpus 2 for a dual-CPU guest.

+ +

A list of supported operating systems can be found by running virt-install --osinfo list.

+ +

If the host hypervisor has a bridged network set up already, such as br0, replace the --network option with --network bridge=br0.

+ + + diff --git a/docs/VirtInstall.txt b/docs/VirtInstall.txt deleted file mode 100644 index e891ef6..0000000 --- a/docs/VirtInstall.txt +++ /dev/null @@ -1,61 +0,0 @@ - Building a VM with virt-install - - -Introduction - - This assumes that the network will be used in "macvtap" mode. This is - the preferred method, as it is faster than a regular bridge and does - not need any additional network configuration on the host. - - The disadvantage of macvtap is that host-to-vm and vm-to-host - communication is blocked. This can be worked around with an - "internal" switch, or by having the macvtap connection bind to a - second interface. - - -Creating the VM - - The following command assumes the OS is "rhel9.1" and the network - card is "eno1". It should be run as the root user or with sudo, and - should be run inside tmux for safety. - - virt-install --name rhel9 \ - --osinfo rhel9.1 \ - --boot uefi \ - --cdrom /var/lib/libvirt/isos/rhel-baseos-9.1-x86_64-dvd.iso \ - --disk /var/lib/libvirt/rhel9.qcow2,size=20 \ - --network type=direct,source=enp2s0,source_mode=bridge \ - --graphics vnc \ - --console pty,target.type=virtio \ - --autoconsole none - - Paths and names should be changed as appropriate. The VNC port can be - found for this example by running "virsh vncdisplay rhel9". - - -Alternative install options - - Import a template image by copying the template into place and - replacing "--cdrom /path/to/disc.iso" with "--import". The file size - is not needed in the --disk option in this case. - - PXE-boot a VM by replacing the "--cdrom /path/to/disc.iso" option - with "--pxe". - - -Tips - - For a virtio network card on Windows machines, add "model=virtio" to - the --network option. - - Other useful options are "--memory 4096" for 4 GB RAM, and - "--vcpus 2" for a dual-CPU guest. - - A list of supported operating systems can be found by running: - - virt-install --osinfo list - - If the host hypervisor has a bridged network set up already, such as - br0, replace the --network option with: - - --network bridge=br0