Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
sebymiano committed Feb 27, 2024
1 parent 4681f83 commit 9ee6cbe
Showing 1 changed file with 53 additions and 0 deletions.
53 changes: 53 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
Questo laboratorio puo' essere svolto in due modi diversi:
1. Utilizzando [Vagrant](#1-svolgimento-con-vagrant) ed un sistema di virtualizzazione (es. Virtualbox o VMware) (**Consigliato**)
2. Utilizzando [Docker](#2-svolgimento-con-docker)
3. Utilizzando le VM fornite (#3-svolgimento-con-le-vm-fornite)

## 1. Svolgimento con Vagrant
Vagrant è uno strumento per la creazione e la gestione di macchine virtuali. In questo caso, verrà utilizzato per creare una macchina virtuale con un sistema operativo Ubuntu 20.04 LTS, con tutti i pacchetti necessari per svolgere il laboratorio.
Expand Down Expand Up @@ -96,3 +97,55 @@ Il supporto a Docker su Windows è limitato. È possibile installare Docker Desk
```bash
$ make connect-docker
```

## 3. Svolgimento con le VM fornite
Sono state fornite delle macchine virtuali con tutti i pacchetti necessari per svolgere il laboratorio. Queste macchine virtuali sono state create per funzionare sia con architetture x86_64 che con architetture ARM64.

Per avviare le macchine virtuali, è necessario utilizzare un provider di virtualizzazione (es. Virtualbox o VMware) e seguire le istruzioni fornite insieme alle macchine virtuali.

### Windows o MacOS with Intel/AMD CPU
1. Installare [Virtualbox](https://www.virtualbox.org)
2. Scaricare la macchina virtuale dal [questo](https://polimi365-my.sharepoint.com/:u:/g/personal/10457521_polimi_it/Eau_qEWlfzBPty42-mEHgAcByGq2rT139ZRKfg3ZK7eWQg?e=m6Rqvz) link.
- Il link è accessibile solo agli studenti del Politecnico di Milano, previa autenticazione con le credenziali istituzionali.
- Se si vuole verificare che il file scaricato sia corretto, verificando l'hash direttamente cosi:
```bash
$ if [ "$(sha256sum sdn-labs-amd64.ova | awk '{print $1}')" = "f95c015797924a18600116a1e49ae11b602c5abdb991fefefe3992262b4c350a" ]; then echo "SHA matches"; else echo "SHA does not match"; fi
```
3. Aprire il file `.ova` con Virtualbox e seguire le istruzioni per importare la macchina virtuale.
4. Avviare la macchina virtuale e attendere che sia completamente avviata.
5. Le credenziali di accesso sono:
- Username: `sdn`
- Password: `sdn`
6. Una volta dentro la VM, aprire il terminale e clonare il repository con il comando:
```bash
$ git clone https://github.com/gverticale/sdn-vm-polimi.git
```
7. Entrare nella cartella ed avviare il docker con il comando:
```bash
$ cd sdn-vm-polimi
$ make connect-docker
```
### MacOS with Apple M1/M2 CPU (ARM64)
1. Installare [VMware Fusion](https://www.vmware.com/products/fusion.html)
- È necessario avere un account VMWare Customer Connect per procedere al download. È possibile iscriversi mediante l'indirizzo email del Politecnico o tramite quello personale: la licenza per VMWare Fusion Player è gratuita sia per scopi personali che per gli studenti.
2. Scaricare la macchina virtuale dal [questo](https://polimi365-my.sharepoint.com/:u:/g/personal/10457521_polimi_it/ESOLW-q6wLVPoUenKGT1OyEBvvzd2gT7QtthJDH1qyeegA?e=fh8RUg) link.
- Il link è accessibile solo agli studenti del Politecnico di Milano, previa autenticazione con le credenziali istituzionali.
- Se si vuole verificare che il file scaricato sia corretto, verificando l'hash direttamente cosi:
```bash
$ if [ "$(sha256sum sdn-labs-arm64.ova | awk '{print $1}')" = "32426af75787c7012297cec081dd0b8ced62aee86af4f5de530bcca414750dce" ]; then echo "SHA matches"; else echo "SHA does not match"; fi
```
3. Aprire il file `.ova` con VMware Fusion e seguire le istruzioni per importare la macchina virtuale.
4. Avviare la macchina virtuale e attendere che sia completamente avviata.
5. Le credenziali di accesso sono:
- Username: `sdn`
- Password: `sdn`
6. Una volta dentro la VM, aprire il terminale e clonare il repository con il comando:
```bash
$ git clone https://github.com/gverticale/sdn-vm-polimi.git
```
7. Entrare nella cartella ed avviare il docker con il comando:
```bash
$ cd sdn-vm-polimi
$ make connect-docker
```

0 comments on commit 9ee6cbe

Please sign in to comment.