Verified Commit 8ff714d7 authored by Nicolas Froger's avatar Nicolas Froger
Browse files

vm: restructure, update some info



Signed-off-by: Nicolas Froger's avatarNicolas Froger <nico@cri.epita.fr>
parent 7ff1c73e
# Tips and tricks
## Screen resolution
You can use the command `xrandr` to change the resolution.
You can see the available resolutions with `xrandr` as following :
![resolution](assets/resolution.png)
You can change it using `xrandr --output Virtual-1 --auto --mode WIDTHxHEIGHT`
![xrandr](assets/xrandr.png)
## Term size
A command line program allows you to change the font size in your terminal.
You can use it with `term_size SIZE`. SIZE being the font size (12, 14, ...
for instance)
# VirtualBox
## Installation
### First step
Install [VirtualBox](https://www.virtualbox.org/).
On Linux you can install it with your package manager
([Debian](https://wiki.debian.org/VirtualBox) or
[Arch Linux](https://wiki.archlinux.org/index.php/VirtualBox)).
### Second step
Download our [VirtualBox appliance](https://static.cri.epita.fr/cri-vm.ova).
Open VirtualBox and go to `File > Import Appliance` and import the file you
just downloaded.
![appliance](assets/vm_external_1.PNG)
![import](assets/vm_external_2.PNG)
![folder](assets/vm_external_3.PNG)
When getting to the `Appliance settings` page, you may adjust the RAM and CPU
parameters. Be careful to have a least 2048 MB of RAM.
You can then click the `Import` button.
![settings](assets/vm_external_4.PNG)
### Third step
Inside Virtual Box select your newly created virtual machine and click on
the `Start` button.
![select](assets/vm_external_5.PNG)
In the familiar PXE menu, choose the `Prepare disk` entry.
Let it boot, a script will run automatically and your VM will shutdown once its
done.
![menu](assets/vm_external_6.PNG)
### Fourth step
You can now `Start` your VM again. You can now use the PXE menu as usual to
boot NixOS image.
You can use the `skip-download` image to avoid downloading the image each time.
Be wary that this image may not be up to date and then have bugs. You should re-download
the VM every once in a while to be sure to have all the latest tools and potential bugs fixes.
You will find more information on this in the `cri.news` newsgroup.
!!! warning
Be careful ! You should log with `epita` user and no password. Your data is in
`/home/epita`, this directory is kept between reboot, you will not lose files
each time you stop your VM.
# VMWare
## Installation
### First step
Install VMWare Workstation : [VMWare Workstation](https://www.vmware.com/products/workstation-player/workstation-player-evaluation.html)
On Linux you can download it with your package manager
([Debian](https://wiki.debian.org/VMware) or [Arch Linux](https://wiki.archlinux.org/index.php/VMware)).
### Second step
Download our [VMWare appliance](https://static.cri.epita.fr/vmware-cri-vm.zip).
Unzip the folder in an appropriate location (you can use `unzip vmware-cri-vm.zip`).
Click on `Open a Virtual Machine`.
![import](assets/vmware.png)
Select the `CRI_VM` folder.
![import1](assets/import_vmware.png)
Select the `CRI VM.vmx` file.
![import2](assets/import2_vmware.png)
### Third step
You now have an imported VM. You can now run it by double clicking on it.
![imported](assets/vmware_vm.png)
In the familiar PXE menu, choose the `Prepare disk` entry.
Let it boot, a script will run automatically and your VM will shutdown once its
done.
![ipxemenu](assets/vmware_ipxe.png)
### Fourth step
You can now `Start` your VM again. You can now use the PXE menu as usual to
boot NixOS image.
You can use the `skip-download` image to avoid downloading the image each time.
Be wary that this image may not be up to date and then have bugs. You should re-download
the VM every once in a while to be sure to have all the latest tools and potential bugs fixes.
You will find more information on this in the `cri.news` newsgroup.
!!! warning
Be careful ! You should log with `epita` user and no password. Your data is in
`/home/epita`, this directory is kept between reboot, you will not lose files
each time you stop your VM.
# VMWare MacOS
## Installation
### First step
For MacOS, install VMWare Fusion : [VMWare Fusion](https://www.vmware.com/go/downloadfusion).
### Second step
Download the iso file [ISO](https://static.cri.epita.fr/cri-vm.iso).
Click on `Installer à partir du disque ou de l'image`.
![import](assets/macos_install_1.png)
Select the `cri-vm.iso` file.
![import1](assets/macos_install_2.png)
Select `Linux` > `Autre noyau Linux 5.x et version ultérieur 64 bits`.
![import2](assets/macos_install_3.png)
Select `BIOS hérité`.
![import2](assets/macos_install_4.png)
Click on `Terminer` and save the VM.
![import2](assets/macos_install_5.png)
Before launching the VM, you need to edit the configuration.
Go to `Machine Virtuelle` > `Paramètres`.
![import2](assets/macos_configure_1.png)
Then edit `Processeurs et mémoires`.
![import2](assets/macos_configure_2.png)
Put (at least) 4096MB of memory. If you can put more - if you have *enough* RAM
available. (Note that 4GB will probably be the maximum on a 8GB Mac).
![import2](assets/macos_configure_3.png)
Go back to the previous menu and click `Disque Dur (SCSI)`.
![import2](assets/macos_configure_2.png)
Put (at least) 64GB of disk space. Note that the disk format is optimized not to
take that much space on your disk.
![import2](assets/macos_configure_4.png)
### Third step
You now have an imported VM. You can now run it by double clicking on it.
![imported](assets/macos_launch.png)
In the familiar PXE menu, choose the `Prepare disk` entry.
Let it boot, a script will run automatically and your VM will shutdown once its
done.
![ipxemenu](assets/vmware_ipxe.png)
### Fourth step
You can now `Start` your VM again. You can now use the PXE menu as usual to
boot NixOS image.
You can use the `skip-download` image to avoid downloading the image each time.
Be wary that this image may not be up to date and then have bugs. You should re-download
the VM every once in a while to be sure to have all the latest tools and potential bugs fixes.
You will find more information on this in the `cri.news` newsgroup.
!!! warning
Be careful! You should log with `epita` user and no password. Your data is
in `/home/epita`, this directory is kept between reboot, you will not lose
files each time you stop your VM.
......@@ -15,7 +15,13 @@ nav:
- 'map.md'
- 'news.md'
- 'print.md'
- CRI VM: 'cri_vm.md'
- CRI VM:
- 'vm/index.md'
- 'vm/virtualbox.md'
- 'vm/vmware.md'
- 'vm/vmware_macos.md'
- 'vm/common_issues.md'
- 'vm/tips.md'
- Disk/USB Installation: 'bare-metal.md'
- Accounts:
- CRI and Bocal accounts: 'accounts.md'
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment