ant/workstation
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Convert docs to HTML

Browse source
This commit is contained in:
Anthony Rose 2023-03-18 19:55:54 +00:00
parent 2c0233f47c
commit b5e4cb235d
2 changed files with 63 additions and 61 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

63
docs/VirtInstall.html Normal file
View file

@ -0,0 +1,63 @@
<!DOCTYPE html>
<html>
<head>
<style type="text/css">
body {
width: 16cm;
margin: auto;
}
</style>
<title>Building a VM with virt-install</title>
</head>
<body>
<h1>Building a VM with virt-install</h1>
<h2>Introduction</h2>
<p>This assumes that the network will be used in <em>macvtap</em> 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.</p>
<p>The disadvantage of macvtap is that host-to-vm and vm-to-host communication is blocked.
This can be worked around with an <em>internal</em> switch, or by having the macvtap connection bind to a second interface.</p>
<h2>Creating the VM</h2>
<p>The following command assumes the machine type is <em>linux2020</em> and the network card is <em>eno1</em>.
It should be run as the root user or with sudo, and should be run inside tmux for safety.</p>
<pre><kbd>virt-install --name <mark>rhel9</mark> \
--osinfo linux2020 \
--boot uefi \
--cdrom <mark>/var/lib/libvirt/isos/rhel-baseos-9.1-x86_64-dvd.iso</mark> \
--disk <mark>/var/lib/libvirt/images/rhel9.qcow2,size=20</mark> \
--network type=direct,source=<mark>enp2s0</mark>,source_mode=bridge \
--graphics vnc \
--console pty,target.type=virtio \
--autoconsole none</kbd></pre>
<p>Highlighted paths and names should be changed as appropriate.
The VNC port can be found for this example by running <kbd>virsh vncdisplay rhel9</kbd>.</p>
<h2>Alternative install options</h2>
<p>Import a template image by copying the template into place and replacing <code>--cdrom /path/to/disc.iso</code> with <code>--import</code>.
The file size is not needed in the <code>--disk</code> option in this case.</p>
<p>PXE-boot a VM by replacing the <code>--cdrom /path/to/disc.iso</code> option with <code>--pxe</code>.</p>
<h2>Tips</h2>
<p>For a virtio network card on Windows machines, add <code>model=virtio</code> to the <code>--network</code> option.</p>
<p>Other useful options are <code>--memory&nbsp;4096</code> for 4&nbsp;GB RAM, and <code>--vcpus&nbsp;2</code> for a dual-CPU guest.</p>
<p>A list of supported operating systems can be found by running <kbd>virt-install --osinfo list</kbd>.</p>
<p>If the host hypervisor has a bridged network set up already, such as <em>br0</em>, replace the <code>--network</code> option with <code>--network bridge=br0</code>.</p>
</body>
</html>

61
docs/VirtInstall.txt
View file

@ -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