Page History

To install SBC software on a virtual machine (VM), you must first create a VM and allocate its resources (for example CPU, memory, and NICs), as well as configure a datastore to contain the SBC operating system and application software.

To create a new SBC SWe KVM instance, perform the following steps.

1. Perform the following to export the display on your desktop if you are remotely accessing the KVM host system.

   1. Log on to KVM host system through SSH and telnet client such as PuTTY using the following command:

      Code Block
      language none
      export DISPLAY=<system_IP>:0.0

      where <system_IP> is the system IP address where GUI is exported for display.
      
      

   2. Enter the following command to launch the virtual machine manager (virt manager) on your system.

      Code Block
      language none
      virt-manager

      
      

      Info
      Ensure Xserver is running on the host system to import the display on your desktop.

      
      

2. Click New to create a new VM.

   Caption
   0 Figure 1 Virtual Machine Manager
   Image RemovedImage Added

   The Create new virtual machine window displays.

   Include Page
   Screenshot_disclaimer Screenshot_disclaimer

3. In Step 1 shown on the Create a new virtual machine window:
   

   1. Select Local install media (ISO image or CDROM).

   2. Click Forward.

      Caption
      0 Figure 1 Create New Virtual Machine
      Image RemovedImage Added

      The locate your install media window displays.

4. In Step 2 on the Create a new virtual machine window:

   1. Select Use ISO image and click Browse.

      Caption
      0 Figure 1 Locate Install Media
      Image RemovedImage Added

      The Choose Storage Volume window displays.

   2. Click Browse Local.

      Info
      The ISO location could be /var/lib/libvirt/images or /root/.

      
      

      Caption
      0 Figure 1 Locate ISO media volume
      Image RemovedImage Added

      
      

5. In Step 2 on the Create a new virtual machine window: 
   1. Click the OS type drop-down list and select Linux.
   2. Click the Version drop-down list and select Debian Stretch.

   3. Click Forward.

      Caption
      0 Figure 1 OS Selection
      Image RemovedImage Added

      The memory and CPU settings window displays.

6. In Step 3 on the Create a new virtual machine window:
   
   1. In the Memory (RAM) field enter 10240 MiB as the RAM size.
   2. In the CPUs field enter 4 as the number of vCPUs.

   3. Click Forward.

      Info
      A minimum of 10 GB of RAM and 4 vCPUs is required for optimal performance.

      
      

      Caption
      0 Figure 1 Memory and CPU Settings
      Image RemovedImage Added

      The storage details window displays.

      Info
      Refer to SBC SWe Performance Metrics for more information on memory required for different call capacities.

      
      

7. In Step 4 on the Create a new virtual machine window:

   1. Select the Enable storage for this virtual machine option.

   2. Select the Create a disk image for the virtual machine option and enter 100 GiB as the hard drive space.

   3. Click Forward.

      Info
      A minimum of 65 GiB is required for optimum performance.

      
      

      Caption
      0 Figure 1 VM Storage Information
      Image RemovedImage Added

      The Ready to begin installation window displays.

8. In Step 5 on the Create a new virtual machine window:

   1. In Name, enter debian.

   2. Select the Customize configuration before install checkbox.

   3. Click Finish.
      

      Caption
      0 Figure 1 VM Installation Information
      Image RemovedImage Added

      The VM configuration screen displays.

9. Perform the following steps to configure the VM settings
   1. In the left pane, click CPUs. The corresponding processor options are displayed.
      
      1. In the CPUs section,
         
         1. Type the required number of CPUs in the Current allocation field.

         2. Type the required number of CPUs in the Maximum allocation field.

            Info
            By default the Current allocation and Maximum allocation fields are set to 1, change them accordingly to the requirement.

            
            

            Info
            The Model field displays the host CPU configuration running on the host system like SandyBridge or Nehalem.

            
            

      2. In the Configuration section, choose host-passthrough as model.
      3. In the Topology section:
         
         1. Select the Manually set CPU topology checkbox.
         2. In the Sockets field, enter 1 as the number of sockets required for the instance.
         3. In the Cores field, enter 2 as the number of cores required for the instance.

         4. In the Threads field, enter 2 as the number of threads required for the instance.

         5. Click Apply. 

            Info
            If your system supports hyperthreading then you enable hyperthreading by mentioning a thread number. This example configures 4 hyperthreaded cores (4 vCPUs).

            
            

            Caption
            0 Figure 1 VM Configuration Screen
            Image RemovedImage Added

            
            

   2. In the left pane, click IDE Disk 1. 

      1. In Advanced options drop-down, choose virtio as Disk bus.

      2. Click Apply. 
         

         Caption
         0 Figure 1 Disk Options Information
         Image RemovedImage Added

         
         

      3. In the left pane, click NIC :xx:xx:xx.   
      4. In Network source drop-down, choose MGT bridge. 

      5. For CentOS 7.x or 8.X when configuring PKT0 and PKT1 In the Device model drop-down, choose virtio instead of the Hypervisor default. If virtio is not selected the management interface will appear during the iso installation.
         

         Caption
         0 Figure 1 System Configuration

         
         

         Image Added

      6. Click Apply.

         Info
         To add HA, PKT0, and PKT1 bridges, click Add Hardware and follow steps i to iii. For the MGT and HA bridges, choose virtio. For the PKT0 and PKT1 bridges, choose Hypervisor default.

         
         

         Caption
         0 Figure 1 Virtual Network Interface
         Image RemovedImage Added

         
         

   3. Configure the VM for CPU pinning to optimize performance. Complete the following steps:

      1. Force off the instance.
      2. Complete the CPU pinning procedure. 

      3. Return to the VM Configuration screen and select Boot Options in the left pane. 

         Caption
         0 Figure 1 Boot Options

         Image Removed

         Image Added

         
         

      4. Update the Boot device order so that IDE CDROM1 is first, followed by VirtIO Disk 1.

      5. Click Apply.

   4. Click Begin Installation.

      Caption
      0 Figure 1 VM Basic Details
      Image RemovedImage Added

      The installation window displays.