123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327 |
- diff --git a/man/virt-install.rst b/man/virt-install.rst
- index 3a6e8dc..078f859 100644
- --- a/man/virt-install.rst
- +++ b/man/virt-install.rst
- @@ -647,17 +647,11 @@ DIRECTORY
-
- Some distro specific url samples:
-
- -Fedora/Red Hat Based
- - https://download.fedoraproject.org/pub/fedora/linux/releases/29/Server/x86_64/os
- +Parabola GNU/Linux-libre
- + https://redirector.parabola.nu/iso/parabola-2021.08.11/parabola-2021.08.11-dual.iso
-
- -Debian
- - https://debian.osuosl.org/debian/dists/stable/main/installer-amd64/
- -
- -Ubuntu
- - https://us.archive.ubuntu.com/ubuntu/dists/wily/main/installer-amd64/
- -
- -Suse
- - https://download.opensuse.org/pub/opensuse/distribution/leap/42.3/repo/oss/
- +Trisquel
- + https://mirror.fsf.org/trisquel-images/trisquel_10.0.1_amd64.iso
-
- Additionally, --location can take 'kernel' and 'initrd' sub options. These paths
- relative to the specified location URL/ISO that allow selecting specific files
- @@ -722,11 +716,11 @@ command has multiple subarguments, similar to --disk and friends. This
- option is strictly for VM install operations, essentially configuring the
- first boot.
-
- -The simplest usage to ex: install fedora29 is:
- +The simplest usage to ex: install parabola is:
-
- .. code-block::
-
- - --install fedora29
- + --install parabola
-
- And virt-install will fetch a --location URL from libosinfo, and populate
- defaults from there.
- @@ -735,7 +729,7 @@ Available suboptions:
-
- ``os=``
- This is os install option described above. The explicit way to specify that
- - would be ``--install os=fedora29`` . os= is the default option if none is
- + would be ``--install os=parabola`` . os= is the default option if none is
- specified
-
- ``kernel=``, ``initrd=``
- @@ -804,19 +798,11 @@ device will be added.
-
- Perform an unattended install using libosinfo's install script support.
- This is essentially a database of auto install scripts for various
- -distros: Red Hat kickstarts, Debian installer scripting, Windows
- -unattended installs, and potentially others. The simplest invocation
- -is to combine it with --install like:
- -
- -.. code-block::
- -
- - --install fedora29 --unattended
- -
- -A Windows install will look like
- +distros. The simplest invocation is to combine it with --install.
-
- .. code-block::
-
- - --cdrom /path/to/my/windows.iso --unattended
- + --install parabola --unattended
-
- Sub options are:
-
- @@ -847,9 +833,6 @@ Sub options are:
- Note that only the first line of the file will be considered, including
- any whitespace characters and excluding new-line.
-
- -``product-key=``
- - Set a Windows product key
- -
-
-
- ``--cloud-init``
- @@ -1005,14 +988,14 @@ For most cases, an OS must be specified or detected from the install
- media so performance critical features like virtio can be enabled.
-
- The simplest usage is ``--os-variant OSNAME`` or ``--osinfo OSNAME``,
- -for example ``--osinfo fedora32``. The supported suboptions are:
- +for example ``--osinfo parabola``. The supported suboptions are:
-
- ``name=``, ``short-id=``
- - The OS name/short-id from libosinfo. Examples: ``fedora32``, ``win10``
- + The OS name/short-id from libosinfo. Examples: ``parabola``
-
- ``id=``
- - The full URL style libosinfo ID. For example, ``name=win10`` is
- - the same as ``id=http://microsoft.com/win/10``
- + The full URL style libosinfo ID. For example, ``name=parabola`` is
- + the same as ``id=https://parabola.nu/parabola/rolling``
-
- ``detect=on|off``
- Whether virt-install should attempt OS detection from the specified
- @@ -1061,7 +1044,7 @@ STORAGE OPTIONS
- ``--disk``
- ^^^^^^^^^^
-
- -**Syntax:** ``--disk`` OPTIONS
- +````Syntax:** ``--disk`` OPTIONS
-
- Specifies media to use as storage for the guest, with various options. The
- general format of a disk string is
- @@ -1190,7 +1173,7 @@ Some example device configuration suboptions:
- "stop", "ignore", or "enospace"
-
- ``serial``
- - Serial number of the emulated disk device. This is used in linux guests
- + Serial number of the emulated disk device. This is used in GNU/Linux guests
- to set /dev/disk/by-id symlinks. An example serial number might be:
- WD-WMAP9A966149
-
- @@ -1218,7 +1201,7 @@ invocation is:
-
- --filesystem /source/on/host,/target/point/in/guest
-
- -Which will work for recent QEMU and linux guest OS or LXC containers. For
- +Which will work for recent QEMU and GNU/Linux guest OS or LXC containers. For
- QEMU, the target point is just a mounting hint in sysfs, so will not be
- automatically mounted.
-
- @@ -2125,66 +2108,22 @@ The debugging information is also stored in
- EXAMPLES
- ========
-
- -The simplest invocation to interactively install a Fedora 29 KVM VM
- +The simplest invocation to interactively install a Parabola KVM VM
- with recommended defaults. virt-viewer(1) will be launched to
- graphically interact with the VM install
-
- .. code-block::
-
- - # sudo virt-install --install fedora29
- + # sudo virt-install --install parabola
-
-
-
- Similar, but use libosinfo's unattended install support, which will
- -perform the fedora29 install automatically without user intervention:
- +perform the parabola install automatically without user intervention:
-
- .. code-block::
-
- - # sudo virt-install --install fedora29 --unattended
- -
- -
- -
- -Install a Windows 10 VM, using 40GiB storage in the default location
- -and 4096MiB of ram, and ensure we are connecting to the system libvirtd
- -instance:
- -
- -.. code-block::
- -
- - # virt-install \
- - --connect qemu:///system \
- - --name my-win10-vm \
- - --memory 4096 \
- - --disk size=40 \
- - --osinfo win10 \
- - --cdrom /path/to/my/win10.iso
- -
- -
- -
- -Install a CentOS 7 KVM from a URL, with recommended device defaults and
- -default required storage, but specifically request VNC graphics instead
- -of the default SPICE, and request 8 virtual CPUs and 8192 MiB of memory:
- -
- -.. code-block::
- -
- - # virt-install \
- - --connect qemu:///system \
- - --memory 8192 \
- - --vcpus 8 \
- - --graphics vnc \
- - --osinfo centos7.0 \
- - --location http://mirror.centos.org/centos-7/7/os/x86_64/
- -
- -
- -
- -Create a VM around an existing debian9 disk image:
- -
- -.. code-block::
- -
- - # virt-install \
- - --import \
- - --memory 512 \
- - --disk /home/user/VMs/my-debian9.img \
- - --osinfo debian9
- + # sudo virt-install --install parabola --unattended
-
-
-
- diff --git a/man/virt-xml.rst b/man/virt-xml.rst
- index ddd586b..102743a 100644
- --- a/man/virt-xml.rst
- +++ b/man/virt-xml.rst
- @@ -182,7 +182,7 @@ GUEST OS OPTIONS
-
- ``--os-variant``, ``--osinfo`` OS_VARIANT
- Optimize the guest configuration for a specific operating system (ex.
- - 'fedora29', 'rhel7', 'win10'). While not required, specifying this
- + 'parabola', 'trisquel'). While not required, specifying this
- options is HIGHLY RECOMMENDED, as it can greatly increase performance
- by specifying virtio among other guest tweaks.
-
- @@ -312,32 +312,32 @@ Change the <description> of domain 'EXAMPLE':
- # virt-xml EXAMPLE --edit --boot menu=on
-
-
- -Clear the previous <cpu> definition of domain 'winxp', change it to 'host-model', but interactively confirm the diff before saving:
- +Clear the previous <cpu> definition of domain 'parabola', change it to 'host-model', but interactively confirm the diff before saving:
-
- .. code-block::
-
- - # virt-xml winxp --edit --cpu host-model,clearxml=yes --confirm
- + # virt-xml parabola --edit --cpu host-model,clearxml=yes --confirm
-
-
- -Change the second sound card to model=ich6 on 'fedora19', but only output the diff:
- +Change the second sound card to model=ich6 on 'parabola', but only output the diff:
-
- .. code-block::
-
- - # virt-xml fedora19 --edit 2 --sound model=ich6 --print-diff
- + # virt-xml parabola --edit 2 --sound model=ich6 --print-diff
-
-
- -Update the every graphics device password to 'foo' of the running VM 'rhel6':
- +Update the every graphics device password to 'foo' of the running VM 'parabola':
-
- .. code-block::
-
- - # virt-xml rhel6 --edit all --graphics password=foo --update
- + # virt-xml parabola --edit all --graphics password=foo --update
-
-
- Remove the disk path from disk device hdc:
-
- .. code-block::
-
- - # virt-xml rhel6 --edit target=hdc --disk path=
- + # virt-xml parabola --edit target=hdc --disk path=
-
-
- Change all disk devices of type 'disk' to use cache=none, using XML from stdin, printing the new XML to stdout.
- @@ -351,37 +351,37 @@ Change disk 'hda' IO to native and use startup policy as 'optional'.
-
- .. code-block::
-
- - # virt-xml fedora20 --edit target=hda \
- + # virt-xml parabola --edit target=hda \
- --disk io=native,startup_policy=optional
-
-
- -Change all host devices to use driver_name=vfio for VM 'fedora20' on the remote connection
- +Change all host devices to use driver_name=vfio for VM 'parabola' on the remote connection
-
- .. code-block::
-
- # virt-xml --connect qemu+ssh://remotehost/system \
- - fedora20 --edit all --hostdev driver_name=vfio
- + parabola --edit all --hostdev driver_name=vfio
-
-
- -Hotplug host USB device 001.003 to running domain 'fedora19':
- +Hotplug host USB device 001.003 to running domain 'parabola':
-
- .. code-block::
-
- - # virt-xml fedora19 --update --add-device --hostdev 001.003
- + # virt-xml parabola --update --add-device --hostdev 001.003
-
-
- -Add a spicevmc channel to the domain 'winxp', that will be available after the next VM shutdown.
- +Add a spicevmc channel to the domain 'parabola', that will be available after the next VM shutdown.
-
- .. code-block::
-
- - # virt-xml winxp --add-device --channel spicevmc
- + # virt-xml parabola --add-device --channel spicevmc
-
-
- -Create a 10G qcow2 disk image and attach it to 'fedora18' for the next VM startup:
- +Create a 10G qcow2 disk image and attach it to 'parabola' for the next VM startup:
-
- .. code-block::
-
- - # virt-xml fedora18 --add-device \
- + # virt-xml parabola --add-device \
- --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
-
-
- @@ -390,22 +390,22 @@ for the guest OS by providing information about it on the command line:
-
- .. code-block::
-
- - # virt-xml fedora18 --osinfo fedora18 --add-device \
- + # virt-xml parabola --osinfo parabola --add-device \
- --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
-
-
- -Hotunplug the disk vdb from the running domain 'rhel7':
- +Hotunplug the disk vdb from the running domain 'parabola':
-
- .. code-block::
-
- - # virt-xml rhel7 --update --remove-device --disk target=vdb
- + # virt-xml parabola --update --remove-device --disk target=vdb
-
-
- -Remove all graphics devices from the VM 'rhel7' after the next shutdown:
- +Remove all graphics devices from the VM 'parabola' after the next shutdown:
-
- .. code-block::
-
- - # virt-xml rhel7 --remove-device --graphics all
- + # virt-xml parabola --remove-device --graphics all
-
-
- Generate XML for a virtio console device and print it to stdout:
|