> For the complete documentation index, see [llms.txt](https://docs.storware.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.storware.eu/70/integrations-plugins/oracle-linux-virtualization-manager-plugin.md).

# Oracle Linux Virtualization Manager UI Plugin

## General

Integration with the OLVM 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 OLVM menu.

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2Fl7WEi4B2KOTPsFwq45b8%2Fintegration_plugins-olvm-general.jpg?alt=media\&token=7354c795-3502-4c86-bc0e-a5950ca5a450)

### Dashboard

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FKWxUyHVataFjZ84AX9Zt%2Fintegration_plugins-olvm-dashboard_1.jpg?alt=media\&token=9375bf61-2666-4ef5-836f-304b545ace53)

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2F8JyZYmrs8gl3GUPAeCpY%2Fintegration_plugins-ovirt-dashboard_2.jpg?alt=media\&token=b33eeb85-b4ac-477f-8c5e-a602e1fc549f)

### Virtual Machines

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FM117R42Pn9KV3YJOTtoA%2Fintegration_plugins-rhv-virtual-machines_1.jpg?alt=media\&token=a8c6172c-1446-4a17-afe1-f6dff3775a14)

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FfF0fwAY1AS9CQ7YmViTg%2Fintegration_plugins-rhv-virtual-machines_2.jpg?alt=media\&token=4b02f946-d3ca-4a1b-a22b-bf5064247d95)

Backup window view:

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FyBlhXZfZ3c0wNfQicRk2%2Fintegration_plugins-rhv-virtual-machines_3.jpg?alt=media\&token=d630e58d-718e-4fe4-94a3-ad365707f200)

### Task console

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FAFGiw560WpEielxfPF1W%2Fintegration_plugins-rhv-task-console.jpg?alt=media\&token=df074b90-bd3f-4df2-a6fb-365b1b99fb8d)

### Policies

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FOWzUdvlBoOZZtsmXg3ts%2Fintegration_plugins-rhv-policies.jpg?alt=media\&token=4f07a229-a0c2-49c1-b871-2ad47ff29778)

### Schedules

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FrVrIrCCVNfnw9iEaystX%2Fintegration_plugins-rhv-schedules.jpg?alt=media\&token=350e1024-5db7-4bd7-8d92-dd2c46c33be4)

### Mounted Backups

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2F3YEWjeAvRhFwOTmfmbwe%2Fintegration_plugins-rhv-mounted-backups_1.jpg?alt=media\&token=5e901be6-1f10-4172-b1e6-f506c30adae7)

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FQLs8VMv2KxCpEEgsJU7L%2Fintegration_plugins-rhv-mounted-backups_2.jpg?alt=media\&token=687dcb59-285f-46f2-824f-b272dda87281)

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

![](https://3557270342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FOE03dnjP5f5aF1buzl%2Fuploads%2FLE4UCw6QFTAzqSdiSAiT%2Fintegration_plugins-rhv-mounted-backups_3.jpg?alt=media\&token=5ac63e39-9775-4c78-a57b-7463953b0af7)

## Installation

{% hint style="info" %}
You can find minimum requirements for Oracle Linux Virtualization Manager UI Plugin in [Support Matrix](/70/overview/support-matrix.md#integration-plugins)
{% endhint %}

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 Oracle Linux virtualization manager.
2. In the file `vprotect.json` edit the 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 OLVM engine.
