Skip to main content

Deploy ECA on Hyper-V

Eyeglass Clustered Agent ECA Hyper-V Installation Guide​

info

The ECA appliance uses 2 disks:

  • OS disk: 32 GB (default disk)
  • Data disk: 120 GB (see instructions below to create)

For complete installation and upgrade procedures, refer to the ECA Install and Upgrade Guide and ECA Admin Guide.

Create ECA Hyper-V Virtual Machine​

Deploy the Virtual Machine​

  1. Download the ECA Hyper-V vhdx file 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 ECA vhdx file.
  8. Complete the Wizard.

Configure ECA Data Disk​

After deploying the VM:

  1. Right-click the new VM and select Settings.
  2. From IDE Controller 0, 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. Create a new blank virtual hard disk: 120 GB.
  8. Complete the data disk Wizard.

Configuration of ECA Cluster​

note

Default Credentials

  • SSH username: ecadmin
  • SSH password: 3y3gl4ss

Configure Node 1 (Master Node)​

  1. Power up the VM and wait 5-10 minutes to allow the Superna on-boot script to run.

  2. Monitor the boot log to ensure the script completes:

    tail -f /var/log/superna-on-boot.log

    Wait for the script to finish, then press Ctrl+C to return to the command prompt.

  3. Run the Hyper-V setup command:

    sudo spy-hyperv-setup

  4. When prompted, enter the admin user password (default password is: 3y3gl4ss) and provide the following network details:

    • IP Address
    • Netmask
    • Gateway
    • Hostname
    • DNS
    • NTP

  5. [STOP] When prompted to mark this node as the master node, DO NOT press y yet. Complete the next section for Node 2-N first.

Configure Node 2-N (Child Nodes)​

Important

Before completing the master node setup, you must configure all additional nodes (Node 2-N) first.

  1. Repeat the deployment steps (Virtual Machine creation and data disk configuration) from the previous section for each additional node.

  2. Power up each additional VM and wait 5-10 minutes for the Superna on-boot script to complete.

  3. Run the Hyper-V setup command on each node:

    sudo spy-hyperv-setup

  4. Provide the network details for each node as prompted:

    • IP Address
    • Netmask
    • Gateway
    • Hostname
    • DNS
    • NTP
Important

When prompted whether this is the master node, enter n for all child nodes (Node 2-N).

Complete Master Node Setup​

After all child nodes (Node 2-N) are configured:

  1. Return to Node 1 (the master node).

  2. When prompted, press y to complete the master node setup.

  3. Enter the ECA cluster name when prompted.

    tip

    Keep the cluster name simple:

    • No uppercase letters
    • No underscores
    • No special characters

  4. Enter the child node IP addresses (space-separated).

  5. Wait for the setup to complete. You will see a setup complete message on all nodes.