Skip to main content

Deploy on Hyper-V

Eyeglass Hyper-V Installation Guide​

note

Tested on Hyper-V Manager (Microsoft Corporation), Version 10.0.14393.0.

info
  • The Eyeglass appliance requires two disks: one for the OS and one for data.
  • The OS disk requires 38 GB and is included by default.
  • The data disk requires 140 GB. See the steps below to create it.

Create Eyeglass Hyper-V Virtual Machine​

  1. Download the vhdx from the Superna Support Portal.
  2. Deploy a new Virtual Machine.
  3. Enter a Name for the VM.
  4. Select Generation 1.
  5. Set Startup memory to 24576 MB (24 GB).
  6. Select a Network Adapter.
  7. Select Use an existing Virtual Hard disk and browse to the downloaded Eyeglass vhdx file.
  8. Complete the Wizard.

Configure Eyeglass Data Disk​

  1. Right-click the new VM and select Settings.
  2. Select IDE Controller 0, then select Hard Drive and click Add.
  3. Click New.
  4. For Disk Format, select VHDX.
  5. For Disk Type, select Fixed size.
  6. Enter a Name for the data disk.
  7. Set the disk size to 140 GB.
  8. Complete the data disk Wizard.

Configure Eyeglass Post Boot​

After booting the Eyeglass VM, configure the local OVF environment file with the network and host settings.

note

Replace all IP addresses and netmasks in the commands below to match your Eyeglass environment.

warning

The second HDD of 140 GB must be added before completing the remaining steps.

  1. Run the following commands to configure the network and host settings:

    sudo su
    /opt/superna/bin/ovf set-value --force net.eth0.ipv4.ip=x.x.x.x
    /opt/superna/bin/ovf set-value --force disk_size=140
    /opt/superna/bin/ovf set-value --force net.eth0.ipv4.gateway=x.x.x.x
    /opt/superna/bin/ovf set-value --force net.eth0.ipv4.netmask=255.255.255.0
    /opt/superna/bin/ovf set-value --force net.nameservers=x.x.x.x
    /opt/superna/bin/ovf set-value --force net.ntp=x.x.x.x
    /opt/superna/bin/ovf set-value --force net.searchlist=example.lan
    /opt/superna/bin/ovf set-value --force vm.hostname=eyeglass

  2. Verify that the .firstboot file exists:

    ls -l /opt/superna | grep .firstboot

    Expected output:

    -rw-r--r-- 1 sca users 0 Sep 10 15:38 .firstboot

  3. If the .firstboot file does not exist, create it and set permissions:

    sudo su
    touch /opt/superna/.firstboot
    chown sca:users /opt/superna/.firstboot

  4. Start the onboot service:

    systemctl restart superna-on-boot

    This operation should return the CLI prompt within 30 seconds.

  5. Review the firstboot log file for any errors or exceptions:

    cat /var/log/superna-on-boot.log

  6. If firstboot succeeds, it should indicate that Hyper-V is detected. Run the following to complete the setup:

    sudo su
    spy-hyperv-setup

    Complete the Hyper-V Setup by entering the requested variables. Once completed, no further setup steps are required.

  7. Log in to the Eyeglass VM at https://x.x.x.x.

  8. Continue with the Install Guide for NTP, licensing, and remaining configuration.