Page History

Configuring Pass-through I/O Devices on ESXi Host

To configure the Passthrough I/O devices on a ESXi host:

1. Select a host from the inventory panel of the vSphere Client.
   
   

2. On the Configuration tab, click Advanced Settings.
   The Passthrough Configuration page appears, listing all the available Passthrough devices.

   Info
   title Note
   A green icon indicates that a device is enabled and active. An orange icon indicates that the state of the device has changed and the host must be rebooted before the device can be used.

3. Click Edit.
   
   

4. Select the devices to be used for Passthrough and click OK.

   Caption
   0 Figure 1 Configuring Passthrough device

   Include Page
   Screenshot_disclaimer Screenshot_disclaimer

   Span

5. Reboot the Host.

   Caption
   0 Figure 1 Rebooting the host

Creating a Virtual Machine (VM)

Perform the following steps to create new

1. Login as user root on VMware vSphere client.

   1. Enter VM Ware host machine IP Address.
   2. Enter your VMware vSphere administrator user name.
   3. Enter your VMware vSphere administrator password. 

   Caption
   0 Figure 1 VMware VSphere Client Login

   The vSphere Client main window appears.

   Include Page
   Screenshot_disclaimer Screenshot_disclaimer

   
   
   

2. In VMware vSphere Client main window, click Getting Started tab. Click Create a new virtual machine.

   Caption
   0 Figure 1 New Virtual Machine Main

   Span

3. Select Custom in Configuration window, and click Next. Provide a Name for your

   Spacevars
   0 product

   . The name can be up to 80 characters. Click Next.

   Info
   title Note
   Avoid special characters for name. Refer to System Name and Hostname Naming Conventions for details.

   Caption
   0 Figure 1 Custom Configuration

   Span

4. From the Storage screen, select a datastore1 and click Next. Ensure datastore has at least 100 GB or more free space. This datastore is required to store all log-related data files.

   Caption
   0 Figure 1 Datastore

   Span

5. Select Virtual Machine Version: 11. Refer to For VMware for more information.
   
   

   Caption
   0 Figure 1 Selecting Virtual Machine Version

   Span

6. From Guest Operating System screen, make the following selections, and then click Next:

   1. Select Linux as the Guest Operating System.
      

   2. Select Debian GNU/Linux 9 (64-bit) from Version drop-down menu.

      Caption
      0 Figure 1 Guest Operating System

      Span

      
      

7. From CPUs screen, make following selections, and click Next. (In the following screenshot example, 4 cores are chosen). For CPU, memory configuration details, see For VMware. 

   1. Number of Virtual sockets: 1

   2. Number of cores per virtual socket: 4 or above (depending on whether all virtual NICs are used)

      Caption
      0 Figure 1 Creating Virtual CPUs

      Span

   3. From the Memory screen, assign memory for the virtual machine, and then click Next. For fewer than 6000 calls, the minimum reservation must be 10 GB. Anything more than 6000 calls require at least 14GB vRAM. Refer to SBC SWe Performance Metrics for more information.

      Caption
      0 Figure 1 Assigning Memory

      Span

8. Define Virtual Machine network interface connections (NICs) using following options from the drop-down menus. Then click Next to continue.

   Caption
   0 Figure 1 Assigning NICs

   Span

    

   1. Select first network adapter (NIC 1:) for management interface. For example, the label can be MGMT which is created using Configuring vNetwork Standard Switches (vSwitches).

   2. Select second network adapter (NIC 2:) for HA interface. For example, the label can be HA.

      Info
      title Note
      These network adapters and labels are already created on the ESX host server. If you are installing for the first time on new ESXi host server, these network adapters and corresponding labels (MGMT, HA) needs to be created. For details, see Configuring vNetwork Standard Switches (vSwitches). The PKT0, and PKT1 is created using the PCI devices. Refer step 14 through 19 for guidance.

      Warning
      Make sure that Network Adapters are mapped exactly in the following order as shown below: First network adapter (Network Adapter 1) for management interface Second network adapter (Network Adapter 2) for high availability

   3. Select Adapter type as VMXNET 3  for both MGMT and HA interfaces.

   4. Ensure all Connect at Power On check boxes are checked. This must be Power On always.
      
      

9. From the SCSI Controller screen, select LSI Logic Parallel as the SCSI Controller option, then click Next to continue.

   Caption
   0 Figure 1 Selecting SCSI Controller

   Span

10. From the Select a Disk screen, select Create a new virtual disk option, then click Next to continue.
    
    

11. From the Create a Disk screen, make the following selections:

    Caption
    0 Figure 1 Selecting Disk Provisioning Option

    Span

     

    1. In Capacity section, assign a minimum of 100 GB or more disk space.

        

    2. In Disk Provisioning section, choose only Thick Provisioning Eager Zeroed option:
       

       1. Thick Provision Lazy Zeroed  - Allocates the requested hard disk (virtual) during the VM creation. This type of disk pre-allocates and dedicates a pre-defined amount of a space for a virtual machine's disk operations, but it does not write zeroes to a virtual machine file system block until the first write within that region at run time.

       2. Thick Provision Eager Zeroed(recommended) - Pre-allocates and dedicates a user defined amount of space for a VM disk operations.

       3. Thin Provision - Creates virtual hard disk during runtime (on write operations). This provides more optimal hard disk usage, but it has some performance impact until it creates maximum requested virtual hard disk.

    3. In Location section, select Specify a datastore or datastore cluster and click Browse...  Select the datastore or NFS where ISO image is available.

       Caption
       0 Figure 1 Specifying Datastore

       Span

    4. Click Next to continue.
       
       

12. From the Advanced Options screen, keep the default value SCSI (0:0) and click Next. The default virtual device node is SCSI (0:0).

    Caption
    0 Figure 1 Selecting Advance Option

    Span

13. From the summary screen, review your VM settings and select the Edit the virtual machine settings before completion option. Click Continue. To go back and change the settings, click Back.

    Caption
    0 Figure 1 Ready to Complete

    Span

14. Click Add to continue the configuration on PKT0 and PKT1.

    Caption
    0 Figure 1 Adding the device

    Span

15. Choose the type of device to add and click Next. For Direct I/O interface, you must select the PCI device.

    Caption
    0 Figure 1 Selecting PCI Device

    Span

16. Select the physical PCI/PCI2 device to connect the packet interface PKT0 and click Next.

    Caption
    0 Figure 1 Specifying the PCI/PCIe Device

    Span

17. PKT Port NUMA Affinity: To find and modify PKT port NUMA affinity, perform the following steps:

    1. Find the PKT port NUMA affinity by executing the following command on the EXSi host:

       Code Block
       vsish -e get /net/pNics/<PKT port name - vmnicX>/properties | grep "NUMA"

    2. Update VM Numa affinity to be same as NIC NUMA affinity:

       1. Edit Settings -> VM options -> Configuration Parameters -> Add Parameters.

          Caption
          0 Figure 1 Edit Configuration Settings

          Span

       2. Add the following parameters:

          Code Block
          numa.nodeAffinity’ = 0 or 1 (based on PKT port NIC affinity) numa.autosize.once = FALSE

          Caption
          0 Figure 1 Add Parameters

          Span

18. Click Finish.

    Caption
    0 Figure 1 Finalizing the Device Details

    Span

19. Repeat the step 14 through 17 to add the physical device to connect the PKT1 interface.

    Info
    title Note
    As it is a Direct I/O, the same Passthrough device must not be used by a multiple VM instances. You must select the different PCI/PCIe device in step 16 for the PKT1 interface.

    Span

20. After adding the PCI devices for both PKT0 and PKT1 interfaces, click Finish to complete.

    Caption
    0 Figure 1 Completing the Task

    Span

    Info
    title Note
    All the NIC ports of the same NIC card has to be fully configured as either pass-through devices or for virtual networking (vSwitches). This is a VMware ESXi limitation/restriction.

21. The virtual machine is created under host IP address with the specified configuration. See the below example screen.

    Caption
    0 Figure 1 Created VM

    Span

    
    This creates the virtual machine.

     

22. After VM is created, you must manually enable autostart and autostop of the Virtual Machine. Enabling the autostop/autostart of Virtual Machine is useful, in scenarios where power is lost and later regained. This setting of VM helps autostart of VMs when the host machine is powered ON.
    To autostart the VM, perform the following steps:

    1. Select the host IP address from left-pane and click Configuration Tab. The Virtual Machine Startup and Shutdown section is displayed.

       Caption
       0 Figure 1 Virtual Machine Startup/Shutdown 3 Virtual Machine Startup/Shutdown

       Span

    2. Click Properties link displayed towards the top-right window.

       1. In System Settings pane, you must ensure to select the Allow virtual machine to start and stop automatically with the system check box. By default it is selected.

          Caption
          0 Figure 1 Enabling Auto Startup and Auto Shutdown of VM 3 Enabling Auto Startup and Auto Shutdown of VM

          Span

       2. In Startup Order pane, select the VM, which you want to automatically start and click Move Up.
          The selected VM is displayed underneath Automatic Startup.

          Caption
          0 Figure 1 Moving VM to AutoStartup 3 Moving VM to AutoStartup

          Span

       3. Click OK.  This completes the autostartup and autoshutdown settings for the Virtual Machine.