# Veeam backup and replication plugin

# Introducción

**Ver**. 04-02-2022  
  
Con este plug-in podremos ver datos de nuestro entorno Veeam Backup como el ultimo backup realizado, los trabajos,etc.

<div id="bkmrk-tipo%3A-plug-in-de-ser"><div>**Tipo**: Plug-in de servidor o agente</div></div>

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="border-collapse: collapse; width: 100%; height: 84px;"><tbody><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde se ha probado**</td><td style="width: 50%; height: 28px;">CentOS 7, Fedora

</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde debería funcionar**</td><td style="width: 50%; height: 28px;">Cualquier sistema linux o en windows ejecutandose en un agente software.

</td></tr></tbody></table>

# Pre requisitos

Se requiere:

- Generar un token para la API de Veeam backup
- Python3
- Librería requests

# Generar token

Con veeam backup replication abierto con el usuario elegido, navega hasta la siguiente dirección url:

```
https://<hostname>:<port>/swagger/ui/index.html
```

\* Port por defecto: 9419

En la página Veeam Backup &amp; Replication REST API 1.0, expanda la sección Login y haga clic en POST api/oauth2/token.

[![image-1643730819768.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/scaled-1680-/image-1643730819768.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/image-1643730819768.png)

En la ventana del método expandido, haz clic en Probar.

En la lista desplegable grant\_type, seleccione password.

En los campos nombre de usuario y contraseña, especifique las credenciales de un usuario creado en Veeam Backup &amp; Replication.

[![image-1643730868633.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/scaled-1680-/image-1643730868633.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/image-1643730868633.png)

Haga clic en Ejecutar.

Espere la respuesta del servidor. Una operación completada con éxito devuelve el código de respuesta 200. En el cuerpo de la respuesta, Veeam Backup &amp; Replication devuelve un token de acceso, su tiempo de caducidad y un token de actualización.

**\* Recuerda que la duración del token de acesso es de solo 15 minutos.**

# Parámetros

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3" style="border-collapse: collapse; width: 100%; height: 318.563px;"><tbody><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">**Parámetro**</td><td style="width: 50%; height: 29.7969px;">**Descripción**</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">-u, --user</td><td style="width: 50%; height: 29.7969px;">Usuario de Veeam</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">-p, --password</td><td style="width: 50%; height: 29.7969px;">Password de Veeam</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">-i,--ip</td><td style="width: 50%; height: 29.7969px;">ip de tu servidor veeam</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">-p,--prefix</td><td style="width: 50%; height: 29.7969px;"> Prefijo para los agentes</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">-g,--group</td><td style="width: 50%; height: 29.7969px;">Grupo de destino de Pandora FMS (opcional)</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">-a, --api\_version</td><td style="width: 50%; height: 29.7969px;">Version de la API</td></tr><tr style="height: 46.5938px;"><td style="width: 50%; height: 46.5938px;">--data\_dir</td><td style="width: 50%; height: 46.5938px;">Directorio de datos de Pandora FMS. **Por defecto** es /var/spool/pandora/data\_in/ (opcional)</td></tr><tr style="height: 63.3906px;"><td style="width: 50%; height: 63.3906px;">--as\_agent\_plugin</td><td style="width: 50%; height: 63.3906px;">Es opcional, si quieres que el plugin sea de agente y te meta los módulos en el agente de pandora, ejecuta esto con un 1 (opcional</td></tr></tbody></table>

# Ejecución manual

Podemos ejecutar el plugin manualmente para mostrar un xml con los datos por pantalla.

```
python3 pandora_veeam.py -i <ip with port> -u <user> -p <password> --as_agent_plugin 1
```

# Configuración en PandoraFMS

La mejor forma de manejar plugins de servidor en Pandora es desde "/usr/share/pandora\_server/util/plugin" asi que lo enviaremos esa ruta.

Después nos moveremos a la carpeta en la que lo hemos metido ( "/usr/share/pandora\_server/util/plugin" es la recomendada").

**Recuerda: Tienes que instalar las dependencias que necesita el módulo Requests en tu sistem**

**Como plugin de servidor**

Iremos a servidores &gt; plugins:

[![image-1629974405286.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/scaled-1680-/image-1629974405286.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974405286.png)

Pinchamos en añadir:

[![image-1629974430627.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/scaled-1680-/image-1629974430627.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974430627.png)

Le ponemos en nombre y la descripción que se prefiera:

[![image-1643988146523.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/scaled-1680-/image-1643988146523.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/image-1643988146523.png)

Metemos como comando la ruta al plugin, y como parámetros los que hemos metido ejecutando el plugin, los campos "\_field\_" son macros definidas más abajo.

[![image-1643988319082.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/scaled-1680-/image-1643988319082.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/image-1643988319082.png)

Ponemos por cada macro la descripción que se prefiera y como valor los datos de tu ip y token.

Una vez hecho esto, solo queda llamarlo por lo que iremos a la vista de algún agente y crearemos un módulo de complementos:

[![image-1646741530197.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-03/scaled-1680-/image-1646741530197.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-03/image-1646741530197.png)

Una vez hecho esto, damos a crear.

Si el modulo se muestra con 1, quiere decir que se esta ejecutando correctamente

Le daremos un nombre y en el apartado "plugin" pondremos el que acabamos de configurar.

**Como plugin de agente**

Lo llamaremos en la última línea del conf del agente con el comando module\_plugin , seguido de la ruta del plugin y de los parámetros utilizados.

```
module_plugin <path pandora_veaambackup.py> -i <ip> -t <token>
```

Esto también se puede hacer desde la consola si esta la configuración remota habilitada.

# Módulos generados por el plugin

El plugin creara 3 agentes con varios módulos, el número de módulos depende de tu entorno de veeam ya que creara uno por cada trabajo creado por ejemplo.

**Veeam\_Backup\_Replication-Services\_and\_configuration**

**[![veeamservicesandconfig2.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/scaled-1680-/veeamservicesandconfig2.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/veeamservicesandconfig2.png)**

**Veeam\_Backup\_Replication-Sessions\_servers\_and\_repositories**

**[![Veeamserversrepos.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/scaled-1680-/veeamserversrepos.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/veeamserversrepos.png)**

**Veeam\_Backup\_Replication-Proxyes\_and\_jobs**

[![image-1643987735037.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/scaled-1680-/image-1643987735037.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/image-1643987735037.png)