# 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.
**Tipo**: Plug-in de servidor o agente
# Matriz de compatibilidad
**Sistemas donde se ha probado** | CentOS 7, Fedora
|
**Sistemas donde debería funcionar** | Cualquier sistema linux o en windows ejecutandose en un agente software.
|
# 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://:/swagger/ui/index.html
```
\* Port por defecto: 9419
En la página Veeam Backup & Replication REST API 1.0, expanda la sección Login y haga clic en POST api/oauth2/token.
[](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 & Replication.
[](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 & 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
**Parámetro** | **Descripción** |
-u, --user | Usuario de Veeam |
-p, --password | Password de Veeam |
-i,--ip | IP de tu servidor Veeam con puerto. Ejemplo : 192.168.1.73:9401 |
J-p,--prefix | Prefijo para los agentes |
-g,--group | Grupo de destino de Pandora FMS (opcional) |
-a, --api\_version | Version de la API. Por defecto : " |
--data\_dir | Directorio de datos de Pandora FMS. **Por defecto** es /var/spool/pandora/data\_in/ (opcional) |
--transfer\_mode | Modo de transferencia de los XML de los agentes. Local o tentacle. Por defecto tentacle. |
--tentacle\_ip | Dirección IP de tentacle a la que se enviaran los XML. Por defecto 127.0.0.1 |
--tentacle\_port | Puerto de tentacle al que se enviarán los XML. Por defecto :41121 |
--interval | Intervalo del agente. Por defecto 300 segundos. |
# Ejecución manual
Podemos ejecutar el plugin manualmente para mostrar un xml con los datos por pantalla.
```
./pandora_veeam -i -u -p
[--prefix ] [--api_version ] [--group ]
[--data_dir ] [--interval ]
[--transfer_mode ] [--tentacle_ip ] [--tentacle_port ]
```
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.
```
curl -k -X POST "https:///api/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "x-api-version: " \
-d "grant_type=password&username=&password="
```
# 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 > plugins:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974405286.png)
Pinchamos en añadir:
[](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974430627.png)
Le ponemos en nombre y la descripción que se prefiera:
[](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:
[](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 -i -t
```
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**
**[](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/veeamservicesandconfig2.png)**
**Veeam\_Backup\_Replication-Sessions\_servers\_and\_repositories**
**[](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/veeamserversrepos.png)**
**Veeam\_Backup\_Replication-Proxyes\_and\_jobs**
[](https://pandorafms.com/guides/public/uploads/images/gallery/2022-02/image-1643987735037.png)