vm-start/README.md

# vm-start

## Description:
script which permit to launch easily some virtual machines via qemu

## Dependencies:

- <u>qemu</u> full installation

## Functionnality:

- create a config file to stores options for a vm [~]
- start a vm while reading for the conf file [ok]
- create a vm with the ability to choose an iso disk to launch the vm [ok]
- del all sata related to a vm [~ok] (misses deleted conf file)
- create a backup or being able to recall the bacup [ok] (can be improved)
- start directly the backup file [ok]
- can create only the conf file instead of starting/creating vm [ok]
- list all vm already created [ok]
- print help of version number [ok]
- support option nproc to launch the vm with a different number of proc than precised in the config file [ok]
- same for option memory [ok]
- same for option size, size is only usefull when creating a vm [ok]
- can support launching vm in uefi mode [ok] (doesn't fully support the UEFI in conf mode, preffer use the option uefi while launching vm.)
- can add customs options to a vm [ok]
- take option create_disk to know what disk to use when creating a vm. [ok]
- compatible to an extensive network configuration [NO] (actually only support nat with ssh forward on localhost:10022)



## Usage:

### to get some help;

vm-start --help

### to list all vm already configured

vm-start --list

### to create a new vm

vm-strart <nom_de_la_vm> create create_disk=<location_of_iso_file>

you can of course add options like uefi to tun in uefi mode, or nproc=<nb_proc> to select a number of processors.

If you go to the conf folder created the first time you launch the script, you will find all configured variables for each of your vm.