Skip to main content
Version: 2.10.0

How to Install Superna Appliances on Nutanix AHV

Introduction​

This guide will take you through the steps necessary to install our appliances on your Nutanix cluster operating on the AHV hypervisor.

Superna supports deployment of our Core and Processing appliances on Nutanix AHV. Superna is “Nutanix Ready AHV” certified. For more information, please visit Nutanix’s Compatibility and Interoperability Matrix and enter “superna” in the “Type to Filter” search bar in the table.

Pre-Requisites​

Before beginning installation you will need the following items for the network set-up of the VM. (You should be able to get this information from your networking team)

  • IP Address
  • Netmask
  • Gateway
  • Hostname
  • DNS Search Domains
  • Name Servers
  • NTP Servers

How to deploy Eyeglass or ECA on Nutanix AHV​

  1. Obtain an image file (qcow2) from Superna's support portal.
  2. Log in to Nutanix Prism using your credentials.

Upload the Image​

  1. Navigate to the Compute & Storage button on the left of the screen.
  2. Under Compute & Storage, click on Images
  3. Click on the blue Add Image button on the top left.
  4. A new page will load, where you will be prompted to upload the file (+Add File button)
  5. Click Next.
  6. A window will appear where you will enter the description for the image, enter it and click Next.
  7. Finally click on Save (leave defaults as they are in the wizard)
info

You can see the image being created and the file being uploaded by going to View All Tasks (on the upper right, the small blue button.).

warning

Do not refresh your screen during the upload.

Create the VM​

Once the upload is complete:

  1. Navigate to the Compute & Storage button on the left of the screen.

  2. Under Compute & Storage, click on VMs

  3. Click on Create VM

  4. Provide: Name, description, cluster (leave default), number of VMs (# of nodes required), and select the number of vCPUs, cores, and assign Memory GBs. The following are the recommended sizing values:

    i. CPU: 4

    ii. Cores Per CPU: 1

    iii. Memory: 16 GB

  5. Click on Next.

  6. Click on Attach Disk. On the dialog that appears, select Operation: Clone from image.

  7. Select the appropriate image to clone from (the qcow2 you've previously uploaded)

  8. Select Bus Type: IDE

  9. Click on Save.

  10. Attach another disk, which will be the blank data drive. (Click on Attach Disk again)

  11. Give it 80GB of capacity (this is the usual capacity set)

  12. Click on Save.

  13. Click on Attach to Subnet, leave the default settings untouched, and click on Save.

  14. Boot Config: Set to Legacy BIOS mode.

  15. Click Next, and when the Management screen opens, click Next again without changing the default options.

  16. Finally, click on Create VM (you may review the settings on this final screen before clicking)

Launch the VM​

  1. Navigate to the Compute & Storage button on the left of the screen.
  2. Under Compute & Storage, click on VMs
  3. On this screen you will find a list of VMs that have been successfully loaded onto the platform. Scroll (if necessary) to find the VM you have just created.
  4. Select the newly created VM by clicking on its name.
  5. A new screen will load, where you will find a button labeled "More" near the top options bar. Click on More, and under it, click on Power ON.
  6. Now you may click on Launch Console, once finished loading, log in with the default username: admin and password: 3y3gl4ss.
  7. Within the VM Console CLI, log in as the root user by using the following command: sudo su. Use the default password given in the previous step.

VM Network and Finishing Setup​

  1. Run the command tail -f /var/log/superna-on-boot.log and wait until it shows "Please execute sudo spy-hypervisor-setup before attempting to use the appliance.". Then, press ctrl+c to return to the command line prompt.

  2. Run the command spy-hypervisor-setup and enter the following information:

    i. IP Address

    ii. Netmask

    iii. Gateway

    iv. Hostname

    v. DNS Search Domains

    vi. Name Servers

    vii. NTP Servers

  3. ECA (Extended Cluster Appliance) nodes step: Run the command sudo -E spy-hypervisor-setup and input the appropriate information when prompted.

    warning

    If deploying multi-nodes ECA, need to run the above command for the non-master nodes first then run for the master node as the last (node 1)

  4. Run the following command:

    tar xvf /opt/data/branding/ui/EYEGLASS.tar.gz -C /srv/www/htdocs/eyeglass --strip-components 1

    and then

    tar xvf /opt/data/branding/ui/EYEGLASSwidgets.tar.gz -C /srv/www/htdocs/eyeglasswidgets --strip-components 1

  5. You should now be able to navigate to the IP address of the appliance in your browser to access the GUI. Congratulations!

Next Steps​

You may now continue to configure your VM as you require.