Проброс USB-устройств в ВМ

Для настройки сквозного подключения USB-флеш-накопителя в ВМ с помощью Numa vServer выполните следующие действия:

  1. Подключите USB-флеш-накопитель к серверу, на котором установлен Numa vServer.
  2. Авторизуйтесь в CLI Numa vServer как локальный суперпользователь root.

  3. Выполните команду для просмотра подключённых USB-флеш-накопителей: 

    1
    xe pusb-list

     1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
    [root@localhost:~]# xe pusb-list
uuid ( RO)            : 77b8f209-4171-522d-92a8-3270f171dba5
            path ( RO): 1-10
      vendor-id ( RO): 0781
    vendor-desc ( RO): SanDisk Corp.
      product-id ( RO): 5571
    product-desc ( RO): Cruzer Fit
          serial ( RO): 00017428010822104644
        version ( RO): 2.00
    description ( RO): SanDisk Corp._Cruzer Fit_00017428010822104644

uuid ( RO)            : 50c69bd0-79d3-dd55-e4e6-85dde8501ee9
            path ( RO): 1-6
      vendor-id ( RO): 058f
    vendor-desc ( RO): Alcor Micro Corp.
      product-id ( RO): 3828
    product-desc ( RO):
          serial ( RO):
        version ( RO): 2.00
    description ( RO): Alcor Micro Corp.

uuid ( RO)            : 730d6957-8ba9-6ba8-ff1d-5b3485fcad10
            path ( RO): 1-7
      vendor-id ( RO): 13fe
    vendor-desc ( RO): Kingston Technology Company Inc.
      product-id ( RO): 4300
    product-desc ( RO):
          serial ( RO): 0708236999B4BE80
        version ( RO): 2.00
    description ( RO): Kingston Technology Company Inc._0708236999B4BE80

  4. Выполните команду для включения сквозной передачи для определенного USB-флеш-накопителя:

    1
    xe pusb-param-set uuid=<pusb-uuid> passthrough-enabled=true

    1
    [root@localhost:~]# xe pusb-param-set uuid=77b8f209-4171-522d-92a8-3270f171dba5 passthrough-enabled=true

    где значение <pusb-uuid> - UUID USB-флеш-накопителя из пункта 2.

  5. Выключите ВМ, для которой необходимо настроить сквозное подключение USB-флеш-накопителя.

    Внимание!

    Убедитесь, что целевая ВМ выведена из механизма высокой доступности.

  6. Узнайте UUID USB-группы, в которую входит подключаемый USB-флеш-накопитель:

    1
    xe usb-group-list PUSB-uuids=<pusb-uuid>

    1
2
3
4
    [root@localhost:~]# xe usb-group-list PUSB-uuids=77b8f209-4171-522d-92a8-3270f171dba5
uuid ( RO)                : 24b42d83-f89e-476b-d5d6-a92877f9fae7
          name-label ( RW): Group of 0781 5571 USBs
    name-description ( RW):

  7. Подключите USB-флеш-накопитель к ВМ:

    1
    xe vusb-create usb-group-uuid=<usb-group-uuid> vm-uuid=<vm-uuid>

    1
2
    [root@localhost:~]# xe vusb-create usb-group-uuid=24b42d83-f89e-476b-d5d6-a92877f9fae7 vm-uuid=b5f3055d-c3a8-f8ef-9c56-3c357c3a2ecb
d885b152-eb32-cbc7-0c14-ef51b9ae4b9c

    где <vm-uuid> – UUID ВМ, для которой необходимо настроить сквозное подключение USB;
    <usb-group-uuid> – UUID USB-группы из пункта 5.

  8. Включите ВМ, в консоли выполните команду lsblk и убедитесь, что USB-флеш-накопитель подключился:

    Подтверждение подключения USB в ВМ
    Подтверждение подключения USB в ВМ

    Примечание

    После выполнения проброса USB-флеш-накопителя для ВМ можно активировать механизм высокой доступности с выбором приоритета "best-effort".

    Внимание!

    Для дальнейшей корректной работы ВМ отключите USB-флеш-накопитель от целевой ВМ. В противном случае часть функций, таких как копирование ВМ, снимки состояния и т.п., работать не будут.

  9. Для отключения USB-флеш-накопителя от ВМ выполните команду: 

    1
    xe vusb-unplug uuid=<vusb-uuid>

    где <vusb-uuid> – значение, выведенное в пункте 6.

  10. Для удаления USB-флеш-накопителя выполните команду: 

    1
    xe vusb-destroy uuid=<vusb-uuid>
    где <vusb-uuid> – значение, выведенное в пункте 6.