vm-start/README.md

56 lines
1.7 KiB
Markdown
Raw Normal View History

2024-01-13 16:06:29 +01:00
# vm-start
## Description:
script which permit to launch easily some virtual machines via qemu
## Dependencies:
- <u>qemu</u> full installation
2024-02-03 02:06:22 +01:00
## Optionnal Dependencies:
- <u>ssh</u> to have possibility to connect via ssh with the remote_connection.sh script.
- <u>rsp</u> to have possibility to connect via rsp with the remote_connection.sh script.
2024-01-31 21:57:21 +01:00
## Functionnality:
- use of config files [~ok]
- start,create vm reading the config file [ok]
- delete all data related to a vm [ok]
- create a backup or being able to recall the bacup [ok - have to be improved]
2024-01-31 21:57:21 +01:00
- start directly the backup file [ok]
- list all vm already configured [ok]
2024-01-31 21:57:21 +01:00
- print help of version number [ok]
- support options to overrides the config file [ok]
- can support launching vm in uefi mode [ok]
2024-01-31 21:57:21 +01:00
- take option create_disk to know what disk to use when creating a vm. [ok]
- compatible to an extensive network configuration [ok, just need the script to create the network. ethernet_restraint/no_restreint can be used while waiting for this script to appear.]
2024-01-31 21:57:21 +01:00
### Next changes to come
- put the path of the creation disk on the config file
- add vnc support
- read from $XDG_CONFIG_DIR/vm_start/conf, or if it not exist, from ~/.config/vm_start/conf.
- improve the create_disk mecanism, and the init_cdrom in a load command.
2024-01-31 21:57:21 +01:00
## Usage:
### to get some help;
2024-02-03 02:06:22 +01:00
`vm-start --help`
### to list all vm already configured
2024-02-03 02:06:22 +01:00
`vm-start --list `
### to create a new vm
2024-02-03 02:06:22 +01:00
`vm-start <nom_de_la_vm> create --create_disk=<location_of_iso_file>`
2024-02-03 02:06:22 +01:00
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.