Metis Guide

  • 24 August 2021
  • 0 replies
  • 153 views

Userlevel 3
Badge +2

Metis

Metis Tool

Metis allows you to qualify and integrate your hardware with Nutanix software.

Nutanix delivers Metis as an .ova or QCOW2 file depending on the hypervisor. Deploy it on a separate utility node or on a laptop using VirtualBox.Note: If you host Metis on a laptop, make sure that the laptop stays running and connected throughout the entire process.

After using Metis, submit the results to the Nutanix Elevate portal. Nutanix uses the results to assess whether the individual hardware components or the entire platform configurations meet the standards to support Nutanix software.

Infrastructure Requirements

  • Foundation VM

  • X-Ray VM

  • DHCP server

Elevate Portal

Details of the Nutanix Elevate portal.

Nutanix maintains a web portal called the Elevate portal as a central location for FleX information, which includes Metis.

After you run tests on your component or platform using Metis, you can upload the results to the Elevate portal.

When you create a qualification ticket in the Elevate portal, the portal assigns the ticket an Elevate ID. Enter this ID when the Metis qualification wizard prompts you for anElevate Project ID.

You do not have to obtain an Elevate ID before qualifying a component or platform. If you leave the Elevate Project ID field in the qualification wizard empty, then when you run the test and click Submit Results to Elevate, Elevate creates an ID automatically.

To upload the test results to the Elevate portal from Metis, the Metis VM must have network connectivity.

Note: If you do not have internet connectivity, then download the test results from Metis by selecting the tests and clicking the Download button. Use this test result bundle in the machine that does have internet connectivity and also attach the bundle to an appropriate Elevate ticket. This is an alternative approach to uploading the results to the Elevate portal from Metis where users do not have internet connectivity at the location that hosts Metis.

Metis Test Profiles

Available test profiles in Metis.

Metis collects groups of tests into profiles. Each profile contains all the tests needed for a given purpose.

To see the available profiles and the tests the profiles contain, go to the Metis toolbar and select Profiles.

Figure. Metis toolbar

Click to enlarge

Metis toolbar.

 

 

Using Metis for Qualification

Qualifying Hardware

Metis supports qualifying one or more hardware components and/or one or more platforms in the same Metis project.

About this task

This chapter describes the workflow for the creation of a standard project. You can also create a custom project. For details, see Custom Projects.

Procedure

  1. In the Metis toolbar, click the Hardware Qualification button.

  2. Click to enlarge

  3. cg_RZA_cXvJ8w9FZkaAhV0F-iXAbz4iS5JS53Zg-QKsv5buwh-dih4MYHfyZq4roSKnb6MKZY9hWbyZFvEI9yKuIVURjeZNwRR893FQ4PfhQm7Cj-BfyIAIsEEfoAHn-HKeih_n8=s0

    The New Qualification Project dialog box appears.

  4. Configure the Project page.

  5. Click to enlarge

  6. 3C7x5uQXZ3ofgwXKUkLgt0AiZgaGlzLFwHcInM-3xQUcOUoIbIEnJtlzc3iRhOf0TwkD8yfixJDCyrin5RDU-BW9rDD4vqbLwX5soH0C054fJkqqd59WnHj9x4tOa5Gpjq6wMFM8=s0
     

    • If you already have an existing Elevate project, you can enter the project ID in the Elevate Project ID field, to associate this project with that ID. (You can find the ID in your Elevate project in the ID field.) If you do not want to associate this project with an Elevate ID, you can leave this field empty.

    • Assign your project a name in the Project Name field.

    • Enter IP addresses for your Foundation and X-Ray VMs.
      Note: Optionally, you can select the check boxes corresponding to these fields to set the IP addresses as global defaults.

  7. Click Next to go to the Targets page.

  8. Click to enlarge

  9. W8IQbVYiw1u1mgT5sLvDfr3y0GNIwYXmTGmDhP1eBwAOEurhhRJw_2O8xcy8MMz_rHhQUMgOJE_FpNhyf46A53IoRBZ-x11B3XMVeUA_x_Lh7k0TALAgvuuFazt5t5JQwv6mRXzJ=s0
     

  10. Select a target or click + Create New Target.

  11. Click to enlarge

  12. New Target dialog.
     

    • In the General tab, assign the target a name and specify the cluster virtual IP address and the DNS server IP address. In the Target Type field, select On Prem or Cloud. If you are using an HCL file, a layout file, or both, add them here.

    • In the Hosts tab, enter your IPMI username, password, and IP addresses, along with the hostname, password, and IP address for your hypervisor.

    • In the Nodes tab, choose a node or click Add Node to specify one.

    • Click to enlarge

    • Add Node dialog.
       

    • To enter the required information, click inside the column under each heading.

    • In the Management tab, select your management software. Enter passwords and other information specific to the software.

    • To create the target, click Create.

  13. Click Next to go to the RPM and Kernel page.

  14. Click to enlarge

  15. RPM and Kernel page.
     

    • If you are performing a qualification that includes bare-metal Linux tests, under CentOS RPM, either upload the RPM file or enter the path to the URL where the RPM is hosted.
      The RPMs are required if you are using a custom driver and need to inject it into our standard CentOS Linux that is used for bare-metal testing. Ensure that you obtain or create an RPM containing the driver or drivers used for the RPM injection. The RPM must be appropriate for the version of CentOS that is available on the Elevate portal.

    • If you are using custom kernels, under Custom Kernels, click the + Add Kernel Bundle button, specify the type of kernels and the name of the kernel tar files.
      In cases where two custom kernels are required, you must provide two drivers.

    • Figure. Add Kernel Bundle

    • Click to enlarge

    • Adding a kernel bundle.
       

    • If you are not performing a bare-metal qualification or using a custom kernel, leave all fields blank.

  16. Click Next to go to the Discovery page.

  17. Click to enlarge

  18. Discovery page.

    Metis examines your system to discover what components are available for qualification. When discovery finishes, the progress bar shows a Complete message.

  19. Click Next to go to the Components page.

  20. Click to enlarge

  21. Components page.
     

  22. Select a test profile from the list, depending on what you want to qualify.

  23. Click Next to go to the Imaging page.

  24. Click to enlarge

  25. LyVXA5rJ_dfZIVuXKUfRfItBNRNw5JwECz0l6GI2KLURjvVEU8ZqCV2p3OeyRJtwXOKhipZiEVRYmwZgTngfm_mOm7dnkyrV5Y4fLB3MNEd28Hy5fofffkvSWc-3R521PuUduna-=s0
     

  26. Specify the image to use for the qualification.

    • To use a prebuilt image, select from the options in the drop-down menu boxes. What options are available in the drop-down boxes depends on which profile you selected in the Components page.

    • To use a custom image, click Upload Custom ISO and specify the image details.

  27. Click to enlarge

  28. eXFN4B01pRJIDctdFrQ2FNytodvCO9JWxH4uDg4ZjDx90JlyO4OmFjoTtO3IkH63VremMm_6auhy7YI1gbrfWOXJM2NgSd_Yd7infmfuyW-bOTTs58RGDTEqYM-n6etFgGt9luJA=s0
     

  29. Click Next to go to the Tests page.

  30. Click to enlarge

  31. WpJwU_jgVrp8Sr_SyQyPPFyq-PvMcz1Ycenv6m6nQGKX8EUao5WKPcNvhaoAYodwXhfDgNTBRR-RLsLDxMyN7Bo5aI29LYZ_j7HrD0GbXb8snH8e7P7dU8AMgQZ82vG5edGq6BRE=s0

    The Tests page displays all the tests included in the profile you selected in the Components page, along with an estimate of the time it takes to run them all.

  32. Click Submit.
    You return to the Metis home page.

  33. In the Metis home page, select the project you just created.

  34. Complete any prerequisites that Metis needs in order to run the tests. Metis alerts you if you have any unmet prerequisites. In the project sidebar, select Prerequisites and take the necessary actions.

  35. Click to enlarge

  36. Prerequisites page.
     

  37. In the project sidebar, select Tests.

  38. Click to enlarge

  39. U62nLuBoK7dHyME8-gp7jQtSN10ZtYobyeoB7_QWSmHuU1Tsg4XYbwfSvP9g9hDzxOVvz1tofPtVRRuI1ihslXdd9uEsguCPJ2hC1zAm4_ztXtQS5f5pUjQnOgcXuUg1pW-INkmo=s0

    Note: The run times listed in the Run time column are estimates. The actual run time varies depending on what size drives you are testing.

  40. Select a checkbox to choose a test or select the Task checkbox to select them all.

  41. Click Add to Schedule.

  42. In the dialog box that appears, drag the tests up or down to set the test order.

  43. Click to enlarge

  44. Reorder tests.

    The graph on the right shows the expected run time of the tests.

  45. Click Add to Schedule.
    Metis runs the tests and shows the progress and results of the tests (passed or failed) in the UI, along with any logs.

  46. Click Upload to Elevate to upload the results to the Nutanix Elevate portal.

Custom Projects

You can customize a project instead of using the default wizard.

Note: Nutanix does not accept test results from custom projects for official qualification.

To create a custom project instead of using the default wizard, click the Custom Hardware Project button on the Metis home page and configure the tabs displayed on the Custom Hardware Project page.

Figure. Custom project

Click to enlarge

Custom project button.

 

 

Troubleshooting

Metis Troubleshooting

Identify and resolve the most common causes of Metis failures.

Procedure

  1. Check for VM issues.

    • Log on to Prism or vCenter and check that the Metis, X-Ray, Foundation, and worker VMs are all up and healthy.

  2. Check for network issues.

    • Log on to the Metis VM and ping the Foundation and X-Ray VMs to make sure that all the VMs are reachable.

    • Log on to the X-Ray VM and ping the worker VMs to make sure that the X-Ray VM can reach the worker VMs.

    • Find the target IPMI addresses in the Metis target configuration, and then log on to each VM to make sure that it can ping each target.

  3. Check test errors.

    • In Metis, select the test that failed and click View Logs. Attach the log file to the Elevate ticket for the FleX support team.

 


This topic has been closed for comments