19.4. The USB Filter Editor

Procedure 19.3. Installing the USB Filter Editor

1. On a Windows machine, launch the USBFilterEditor.msi installer obtained from the Content Delivery Network.
2. Follow the steps of the installation wizard. Unless otherwise specified, the USB Filter Editor will be installed by default in either C:\Program Files\RedHat\USB Filter Editor or C:\Program Files(x86)\RedHat\USB Filter Editor depending on your version of Windows.
3. A USB Filter Editor shortcut icon is created on your desktop.

Procedure 19.4. Adding a USB Policy

1. Click the Add button. The Edit USB Criteria window opens:
   

   View larger image

   

   Figure 19.2. Edit USB Criteria

2. Use the USB Class, Vendor ID, Product ID, and Revision check boxes and lists to specify the device.
   Click the Allow button to permit virtual machines use of the USB device; click the Block button to prohibit the USB device from virtual machines.
   Click OK to add the selected filter rule to the list and close the window.

   Example 19.1. Adding a Device

   The following is an example of how to add USB Class Smartcard, device EP-1427X-2 Ethernet Adapter, from manufacturer Acer Communications & Multimedia to the list of allowed devices.

   

   View larger image

   
3. Click File Save to save the changes.

Procedure 19.5. Removing a USB Policy

1. Select the policy to be removed.

   

   View larger image

   

   Figure 19.3. Select USB Policy

2. Click Remove. A message displays prompting you to confirm that you want to remove the policy.
   

   View larger image

   

   Figure 19.4. Edit USB Criteria

3. Click Yes to confirm that you want to remove the policy.
4. Click File Save to save the changes.

Procedure 19.6. Searching for USB Device Policies

1. Click Search. The Attached USB Devices window displays a list of all the attached devices.

   

   View larger image

   

   Figure 19.5. Attached USB Devices

2. Select the device and click Allow or Block as appropriate. Double-click the selected device to close the window. A policy rule for the device is added to the list.
3. Use the Up and Down buttons to change the position of the new policy rule in the list.
4. Click File Save to save the changes.

Procedure 19.7. Exporting a USB Policy

1. Click Export; the Save As window opens.
2. Save the file with a file name of usbfilter.txt.
3. Using a Secure Copy client, such as WinSCP, upload the usbfilter.txt file to the server running Red Hat Virtualization Manager. The file must be placed in the following directory on the server:

   /etc/ovirt-engine/
4. As the root user on the server running Red Hat Virtualization Manager, restart the ovirt-engine service.

   # systemctl restart ovirt-engine.service

   Copy to Clipboard Toggle word wrap

Procedure 19.8. Importing a USB Policy

1. Using a Secure Copy client, such as WinSCP, download the usbfilter.txt file from the server running Red Hat Virtualization Manager. The file can be found in the following directory on the server:

   /etc/ovirt-engine/
2. Double-click the USB Filter Editor shortcut icon on your desktop to open the editor.
3. Click Import to open the Open window.
4. Open the usbfilter.txt file that was downloaded from the server.