# Hyper-V

Un ringraziamento speciale al nostro contributore della community [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) per aver creato e condiviso questo utile video tutorial:

{% embed url="<https://www.youtube.com/watch?v=StVw-60Piuk>" %}

### 1. Preparazione <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

{% stepper %}
{% step %}
**Scarica il** CUBE OS **immagine**

Visita questo [repository](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) per scaricare l'ultima `.vmdk` immagine. Si prega di estrarre l'immagine dopo il download.
{% endstep %}

{% step %}
**Installa Hyper-V**

Windows 10 / 11 Pro, Enterprise o Education (richiesto Hyper-V)

Hyper-V abilitato sul tuo sistema: prima di usare Hyper-V, assicurati che sia abilitato in Windows. Apri **Pannello di controllo → Programmi → Attiva o disattiva funzionalità Windows**,&#x20;

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FWDcT9mnUIFijGtyKD6cm%2Fimage.png?alt=media&#x26;token=e436eae3-61cb-4e08-a3e0-612f0b37960b" alt="" width="310"><figcaption></figcaption></figure></div>

abilita **Hyper-V** (inclusi *Strumenti di gestione Hyper-V* e *Piattaforma Hyper-V*), **Piattaforma Macchina Virtuale**, **Piattaforma Hypervisor di Windows**, quindi fai clic su **OK** e riavvia il computer.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FULGXxO2KkrnniwM6CQvr%2Fimage.png?alt=media&#x26;token=0ce61757-dbf8-4ba5-9ab9-b8d635250028" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Adattatore Zigbee (opzionale)**

Se hai bisogno di aggiungere dispositivi Zigbee USB, nota che Hyper-V non supporta il passthrough USB nativo per dispositivi hardware come dongle Zigbee. Se è necessario l'accesso USB, considera l'uso di una **soluzione USB-over-IP** o un **coordinatore Zigbee basato su rete** invece.
{% endstep %}
{% endstepper %}

### 2. Convertire l'immagine CUBE OS in VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Prima di creare la macchina virtuale, converti l'immagine del disco di CUBE OS in un formato Hyper-V **VHDX** compatibile.

{% stepper %}
{% step %}
Scarica e installa uno strumento di conversione immagine VM, come **VM Image Converter** (consigliato su Windows)&#x20;

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FClQstydrldjmcLuKnY6J%2Fimage.png?alt=media&#x26;token=82d68ed0-cbdb-40ab-a655-43355f62d0d9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Avvia il convertitore e seleziona:

* Formato sorgente: **VMDK**
* Formato di destinazione: **VHDX**

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F7iCfbFg9ACqHTf4qWAMQ%2Fimage.png?alt=media&#x26;token=9cdf81ab-e4b2-4cd9-a75f-f6a265b57973" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Completa la conversione e annota la posizione del `.vhdx` file generato.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQKS70hxaW1oTz6RCwmic%2Fimage.png?alt=media&#x26;token=eeffdb9e-2408-46aa-926e-a1be47ad6bb2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. Crea la macchina virtuale <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Avvia **Hyper-V Manager**.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FKLGnYhpnW4TUgAiSVzta%2Fimage.png?alt=media&#x26;token=27dfe2ee-cefa-473b-a5eb-397ecf905871" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Fai clic su **Creazione rapida** → Seleziona![](https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8yCryNG9EQ2ZML71mllN%2Fimage.png?alt=media\&token=d005ecdb-686a-4373-bf54-14a94a273d1f)**Sorgente di installazione locale**.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Ff5qgA3WXeEw1KlNAQehR%2Fimage.png?alt=media&#x26;token=6f4f67dc-11c5-4f87-b794-26cb34e01b97" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Seleziona **Cambia sorgente di installazione**, seleziona il **CUBE OS `.vhdx`** file convertito e disabilita **Windows Secure Boot**.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FLekBkkamd2Hydx4xsEYv%2Fimage.png?alt=media&#x26;token=0ed27f1f-3756-4fdf-8dab-d3491a5ca132" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Inserisci un nome per la VM (per esempio, `CUBE OS`), e poi **Crea macchina virtuale**.
{% endstep %}
{% endstepper %}

### 4. Configura le impostazioni della macchina virtuale <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Fai clic su **Impostazioni** per la macchina virtuale appena creata.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FlyxZ9KvMx4bpzL0cQEes%2Fimage.png?alt=media&#x26;token=e6cbd439-042d-4cef-821a-7d86bf1558bc" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Assegna risorse di sistema:

* Minimo: **4096 MB (4 GB)**
* Disabilita la Memoria Dinamica (consigliato).
* **Processore**: 2 processori virtuali

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZdfwbJkXE2NyfMI6Wcsb%2Fimage.png?alt=media&#x26;token=c941758a-e5b1-44ad-91e9-03f757a6434f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Fai clic su **Applica** e **OK** per salvare le impostazioni.
{% endstep %}
{% endstepper %}

### 5. Avvia CUBE OS

{% stepper %}
{% step %}
Fai clic su **Connetti** e **Avvia** la macchina virtuale creata.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FafxqxaM2WCQFAmiBM1PL%2Fimage.png?alt=media&#x26;token=78525be1-b531-4151-af31-c4a3952da45e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Attendi qualche istante affinché CUBE OS si inizializzi. Monitora lo schermo di avvio fino al completamento del boot.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FmsvbU2r30xq0WmtqjTLP%2Fimage.png?alt=media&#x26;token=bbe50140-3a33-4d18-92cf-43df705b49b1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Una volta completato, vedrai l'IP di CUBE OS visualizzato sullo schermo. Usa questo indirizzo IP o [cube.local](http://cube.local/) per accedere alla pagina di gestione Web di CUBE OS.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Una volta effettuato l'accesso con successo, un ID breve sarà visibile nella pagina delle impostazioni. Successivamente, accedi alla pagina di gestione Web di CUBE OS usando `cube-{short id}.local`, che è utile per differenziare più istanze di CUBE OS sulla stessa rete locale.

<div align="left"><figure><img src="https://2847557189-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}