# oVirt UI Plugin

## General

Integration with the oVirt Virtualization interface allows administrators to perform most of the basic operations without logging into the Storware Backup & Recovery dashboard.

After installation (which is described at the end of this article) you will see a new tab "VM Backups" in the oVirt menu.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/jk0tQj5KB2WlosHAt93k/integration_plugins-ovirt-general.jpg)

### Dashboard

As usual, it contains a short summary of the environment along with a handful of statistics.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/iVp8JCQPUFPqJ2thRnmW/integration_plugins-ovirt-dashboard.jpg)

You can also see the data summary of the backup destination.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/5KbY6fkt1MkmtEYyHQaq/integration_plugins-rhv-dashboard_2.jpg)

### Virtual Machines

This tab shows all inventoried virtual machines in your oVirt environment. Besides, you can also perform the basic backup or restore operations.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/QCSSESti60Mp6ouHP7hv/integration_plugins-rhv-virtual-machines_1.jpg)

But that's not all, you can also go into the details of the virtual machine by clicking on its name:

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/kd6uEu5fhyDbuwITmicK/integration_plugins-rhv-virtual-machines_2.jpg)

Backup window view:

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/TdVKu4u4xeCmPo9fM6rJ/integration_plugins-rhv-virtual-machines_3.jpg)

### Task console

Basic information about current tasks performed by Storware Backup & Recovery.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/Kpa7AjIGGyaBAA0Dui8N/integration_plugins-rhv-task-console.jpg)

### Policies

Allows you to create policies for VM's backups and snapshots. It basically has the same functionalities as Storware Backup & Recovery WebUI.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/9Gh0GgpLsIrwtRR1iGDl/integration_plugins-rhv-policies.jpg)

### Schedules

As with the policies tab, it allows you to create schedules for the created rules.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/3f11cViLb2Je22q9IwGc/integration_plugins-rhv-schedules.jpg)

### Mounted Backups

Finally, you can also browse your mounted backups from the oVirt dashboard. You only need to enter the backup details using the menu on the right.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/FFmVdYIUvOOPbAPO2sV2/integration_plugins-rhv-mounted-backups_1.jpg)

From here we can see the basic information about the backup and start browsing the files using the "Browse" button on the right.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/Oyjh3vmtC78f5dnqXE3J/integration_plugins-rhv-mounted-backups_2.jpg)

Just select a folder or file and then press the "download selected" button to have the files on your computer.

![](https://content.gitbook.com/content/wUsKWUrceYHp8e9TJ00e/blobs/jCvUbw7ghhPmmm9faaTy/integration_plugins-rhv-mounted-backups_3.jpg)

## Installation

1. You can find the add-on in the [GitHub repository](https://github.com/Storware/ovirt-engine-ui-vprotect-extensions). Follow the instructions in the README to build or download the plugin. Then extract the provided archive onto your oVirt manager.
2. In the file `vprotect.json` edit these lines in the config part:
   * `Storware_URL` - the URL to Storware Backup & Recovery API
   * `username` - the name of admin in Storware Backup & Recovery
   * `password` - the admin password in Storware Backup & Recovery

**Example**:

```
   {
      "name": "vprotect",
      "url": "plugin/vprotect/plugin.html",
      "resourcePath": "vprotect-resources",
      "lazyLoad": false,

      "config": {
          "vProtectURL": "http://10.40.0.55:8080/api",
          "username": "admin",
          "password": "vPr0tect"
       }
   }
```

1. Put the `vprotect.json` file and `vprotect-resources` directory in the `/usr/share/ovirt-engine/ui-plugins` directory in the oVirt Engine.