# 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 MS Windows® ejecutándose en un EndPoint.

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

# Pre requisitos

Se requiere:

- Conectividad hacia tu entorno de Veeam Backup

# Generar token (Deprecado)

**Actualizado 20 enero 2025**

**En la ultima versión del plugin, el token lo genera este pasandole usuario y contraseña, por lo que este apartado esta deprecado.**

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: 441.532px;"><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 con puerto. Ejemplo : 192.168.1.73:9401</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">J-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. Por defecto : " <div><div>1.0-rev2"</div></div></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.375px;"><td style="width: 50%; height: 63.375px;">--transfer\_mode</td><td style="width: 50%; height: 63.375px;">Modo de transferencia de los XML de los agentes. Local o tentacle. Por defecto tentacle.</td></tr><tr style="height: 46.5938px;"><td style="width: 50%; height: 46.5938px;">--tentacle\_ip</td><td style="width: 50%; height: 46.5938px;">Dirección IP de tentacle a la que se enviaran los XML. Por defecto 127.0.0.1</td></tr><tr style="height: 46.5938px;"><td style="width: 50%; height: 46.5938px;">--tentacle\_port</td><td style="width: 50%; height: 46.5938px;">Puerto de tentacle al que se enviarán los XML. Por defecto :41121</td></tr><tr style="height: 29.7969px;"><td style="width: 50%; height: 29.7969px;">--interval</td><td style="width: 50%; height: 29.7969px;">Intervalo del agente. Por defecto 300 segundos.</td></tr></tbody></table>

# Ejecución manual

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

```
./pandora_veeam -i <ip with port> -u <user> -p <password> 
[--prefix <prefix>] [--api_version <api_version>] [--group <group>] 
[--data_dir <data_dir>] [--interval <interval>] 
[--transfer_mode <transfer_mode>] [--tentacle_ip <tentacle_ip>] [--tentacle_port <tentacle_port>]
```

<p class="callout warning">Si al ejecutarlo, ves el error : Error getting token, es probable que no se tenga acceso al entorno. Puedes probar con el siguiente curl para verificar que es problema de interactividad.</p>

```
curl -k -X POST "https://<user_ip>/api/oauth2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -H "x-api-version: <api_version>" \
     -d "grant_type=password&username=<user>&password=<password>"
```

<div id="bkmrk-"></div>

# 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").

**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.

Ponemos por cada macro la descripción que se prefiera. Recuerda que en este plugin los tres parámetros de uso obligatorio son el user, password e IP, los demás son opcionales.

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)