# 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: - 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://:/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. [![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 & 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 & 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, --userUsuario de Veeam
-p, --passwordPassword de Veeam
-i,--ipip de tu servidor veeam
-p,--prefix Prefijo para los agentes
-g,--groupGrupo de destino de Pandora FMS (opcional)
-a, --api\_versionVersion de la API
--data\_dirDirectorio de datos de Pandora FMS. **Por defecto** es /var/spool/pandora/data\_in/ (opcional)
--as\_agent\_pluginEs 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
# Ejecución manual Podemos ejecutar el plugin manualmente para mostrar un xml con los datos por pantalla. ``` python3 pandora_veeam.py -i -u -p --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 > 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 -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** **[![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)