Hype-2/DOCUMENTATION.md

# Documentation

 This is more a techincal documentation that how to use this tool.

# Install

Please refer to the README file, all install steps are described.

## Pipx

Not refered in the install, but you can pipx for you install.

# Virtual Server Creation

## Linux

For the moment, no issue with tested distribution:
  - Archlinux
  - Debian/ubuntu
  - Centos/Fedora/Redhat
  - FreeBSD
  - TinyCore

## Other install

Tested succeffully :
  - Pfsense,Dynfi,Open

## Windows

Windows OS will need some extra-drivers to run on virtualized server.

For this during the install, the VM will need a virtIO-win iso with all drivers.
The VirtIO iso is already mounted as a CD-ROM on VM creation. Load the drivers according to you OS install.

### VirtIO

VirtIO is a QEMU drivers for Windows OS (please read : https://developer.ibm.com/articles/l-virtio/)

VirtIO can be found here :
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/archive-virtio/?C=M;O=D

Take care of the version, some virtio are not compatible with some Windows version.

This iso is on ./storage/win/ and configured in **config.py** for upgrade.

### Tested Windows Installation (tested with Virtio 0.1.229):

Validate for :
  - Windows 8, 8,1 10
  - Windows Server 2019, 2022

Failed with :
  - Windows 98, Windows XP, Windows 11 (UEFI access)

Never Tested :
  - Win 7 and Vista


# ERROR and SOLUTION

You may incounter some error in specific case, please report them if they are not in the list,
They will be consider on nexts releases.

ERROR: Error destroying Requested operation is not valid: cannot undefine domain with nvram :
SOLUTION (on CLI): virsh undefine --nvram VM_NAME

ERROR: Error stoping NOM_VM:Requested operation is not valid: domain is not running
SOLUTION 1 (on CLI): virsh reset VM_NAME
SOLUTION 2 (on CLI): virsh destroy VM_NAME (destroy the VM)