Whitepaper — PodHeitor OracleDB - PodHeitor — Backup, Replicação e Recuperação de Desastres

Respaldo Oracle Database integrado con RMAN. Hot backup, archive log streaming, PITR al SCN, soporte Data Guard primario/standby, RAC y PDB multi-tenant.

Integración RMAN nativa — control de catálogo, validación BLOCKRECOVER automática.
Archive log streaming continuo — RPO cerca de cero.
PITR al SCN — restauración precisa por número de transacción Oracle.
Data Guard-aware — respaldo desde standby, cero overhead en primario.
RAC y multi-tenant (PDB) — respaldo individual de PDB, restore a otro CDB.

Producción en 30 días, al menos 50% más barato. Trial gratuito, RPMs y DEBs firmados, soporte directo con Heitor Faria. Reemplace su licencia Veeam, Commvault o Bacula Enterprise sin romper la ventana nocturna.

Solicitar trial gratuito de 30 días →

OFERTA COMERCIAL — LEA ESTO PRIMERO

¿Está migrando desde Bacula Enterprise, Veeam, Commvault o NetBackup? Traiga su cotización de renovación o propuesta de contrato vigente y le garantizamos un descuento mínimo del 50% — con significativamente más funcionalidades incluidas de serie.

Tabla de Contenidos

Resumen Ejecutivo
El Problema
Descripción General de la Solución
Arquitectura
Tabla Comparativa de Funcionalidades
Referencia de Opciones de Backup
Referencia de Opciones de Restauración
Ejemplos de Configuración de FileSet
Ejemplos de Job de Restauración
Guía de Instalación y Dimensionamiento
Matriz de Compatibilidad
Informe de Rendimiento
Seguridad y Cumplimiento Normativo
Soporte y Condiciones Comerciales
Apéndice A — Registros de Decisiones de Arquitectura
Apéndice B — Glosario

1. Resumen Ejecutivo

¿Qué es?

El Plugin de Backup y Replicación de OracleDB de PodHeitor para PodHeitor Backup es un plugin para el File Daemon de Bacula de nivel productivo y acabado comercial que ofrece protección integral de bases de datos Oracle — desde backups en caliente mediante RMAN SBT v2 hasta protección de datos continua (CDP) y replicación nativa de recuperación ante desastres — a una fracción del costo de las alternativas propietarias.

Escrito íntegramente en Rust (construido en Rust con seguridad de memoria nativa y cero dependencias de runtime), el plugin se distribuye como un único paquete RPM o DEB (menos de 700 KB instalado) y no requiere bibliotecas de terceros específicas de Oracle, implementaciones propietarias de SBT ni scripts de shell externos a Bacula.

Valor de Negocio en Tres Puntos

Reducción de costos superior al 50%. El backup de bases de datos Oracle es una de las partidas más costosas en cualquier presupuesto de TI empresarial. Bacula Enterprise cobra tarifas de licencia por cliente o por agente que se acumulan con cada instancia Oracle que se protege. Veeam, Commvault y NetBackup añaden licencias de agente, módulos adicionales y mantenimiento anual. PodHeitor ofrece todas las capacidades de esas plataformas — y varias que ellas no tienen — a un precio fijo por organización (sin cobro por socket ni por TB).

Más funcionalidades, no menos. Esta no es una alternativa de código abierto recortada. El plugin supera a Bacula Enterprise 18.2.3 en protección de datos continua (modo daemon CDP), replicación DR nativa para Standard Edition 2 (archivelog-apply), observabilidad con Prometheus/OpenTelemetry, detección de canary anti-ransomware, validación automatizada con DBVERIFY tras la restauración e integridad de la cadena de suministro mediante CycloneDX SBOM. Bacula Enterprise no incluye ninguna de estas características.

Automatización de restauración nativa de Bacula. Los productos competidores requieren que un operador acceda por SSH al host Oracle e invoque un script Perl (bs_oracle_restore.pl) o un wrapper de shell equivalente — fuera de cualquier pista de auditoría. PodHeitor utiliza el mecanismo incorporado de RestoreObject de Bacula: un documento pluginrestoreconf incluido en cada backup desencadena una restauración completamente automatizada y catalogada directamente desde bconsole o la consola web de Bacularis. No se requiere SSH al host Oracle.

Quién Debe Leer Este Documento

DBAs de Oracle que evalúan estrategias de backup para cargas de trabajo de 11g hasta 23ai.
Administradores de Bacula que buscan reemplazar un plugin comercial de Oracle sin rediseñar su infraestructura.
Arquitectos de Infraestructura que diseñan pipelines de recuperación ante desastres y replicación de datos para entornos Oracle Standard Edition 2 o Enterprise Edition.
Equipos de Adquisiciones de TI que comparan costos de licencias y paridad de funcionalidades con Bacula Enterprise, Veeam for Oracle, Commvault IntelliSnap Oracle y NetBackup for Oracle.

2. El Problema

El Backup de Oracle es Singularmente Complejo

El backup de Oracle Database no es como respaldar un sistema de archivos o una base de datos relacional simple. Un backup correcto de Oracle debe contemplar:

Consistencia de SCN — los backups que abarcan múltiples datafiles deben ser consistentes en el mismo System Change Number o producirán un conjunto irrecuperable.
Integridad de la cadena de archivelogs — la recuperación a un punto en el tiempo requiere una secuencia ininterrumpida de redo logs archivados desde el último backup Full hasta el momento objetivo.
Controlfile y SPFILE — la base de datos no puede montarse sin estos archivos; deben respaldarse de forma atómica junto con cada backup de datafiles.
Multitenant (CDB/PDB) — Oracle 12c y versiones posteriores permiten cientos de bases de datos conectables dentro de un contenedor; una estrategia de backup debe abordar tanto el contenedor raíz como los PDBs individuales de forma independiente.
Cifrado TDE — los wallets de Transparent Data Encryption deben respaldarse y rotarse de forma coordinada o la restauración se vuelve imposible.
ASM y RAC — Grid Infrastructure añade abstracción de almacenamiento (ASM) y paralelismo en clúster (RAC) que las herramientas de backup genéricas no pueden ver.

RMAN (Recovery Manager) es el motor de backup nativo de Oracle y la única herramienta que aborda plenamente todos estos requisitos. Cualquier solución de backup de Oracle creíble debe integrarse con RMAN a un nivel profundo — no ejecutando rman target / y archivando los archivos de salida como si fueran objetos arbitrarios del sistema de archivos.

El Problema del Costo

Producto	Costo Típico de Backup Oracle	Notas
Bacula Enterprise	US$ 3.000–US$ 8.000 / año por host Oracle	Módulo Oracle adicional sobre la licencia base del FD
Veeam for Oracle	US$ 2.500–US$ 6.000 / año por socket	Requiere Veeam Backup & Replication Enterprise Plus
Commvault IntelliSnap Oracle	US$ 5.000–US$ 15.000 / año por host	Licencia de agente + IntelliSnap
NetBackup for Oracle	US$ 4.000–US$ 12.000 / año por host	Licencia de cliente NBU + agente de BD
PodHeitor	Tarifa fija por organización (sin costo por host)	Soporte comercial disponible del autor

Los rangos de precios son indicativos, basados en precios de lista públicamente disponibles e informes de la comunidad a partir de 2026. Los precios negociados reales varían. El punto central es claro: para una organización que protege 10 hosts Oracle, el ahorro anual en comparación con cualquier solución propietaria oscila entre US$ 25.000 y US$ 150.000.

El Problema de la Restauración — El Costo Oculto

El costo de las herramientas propietarias de backup de Oracle no es solo la tarifa de licencia. El costo oculto es la complejidad de la restauración.

Bacula Enterprise 18.2.3 incluye un script Perl llamado bs_oracle_restore.pl. Para realizar una recuperación a un punto en el tiempo, un DBA debe:

Acceder por SSH al host Oracle (requiere acceso al sistema operativo, VPN y gestión de claves).
Localizar la versión correcta de bs_oracle_restore.pl (cambia entre versiones de Bacula).
Ejecutar el script con los parámetros correctos — una docena de indicadores sin validación interactiva.
Confiar en que el script genere los comandos RMAN correctos para el timestamp objetivo.
Monitorear el progreso directamente en el host Oracle — sin entrada en el catálogo de Bacula para la operación de restauración.
Abrir manualmente la base de datos con RESETLOGS si el script no lo hace automáticamente.

Este flujo de trabajo es propenso a errores, no es auditable y requiere acceso a nivel del sistema operativo que la mayoría de las políticas de seguridad prohíben otorgar a los DBAs de capa de aplicación.

PodHeitor elimina todo esto. El flujo completo de restauración — incluidas las acciones de PITR, basada en SCN, a nivel de tabla, clonación y validación — se gestiona desde bconsole o el formulario web de Bacularis, con una pista de auditoría completa en el catálogo de Bacula y sin necesidad de acceso SSH al host Oracle.

La Brecha en Replicación y CDP

Ninguno de los cuatro principales productos competidores (Bacula Enterprise, Veeam, Commvault, NetBackup) incluye protección de datos continua (CDP) nativa ni replicación de recuperación ante desastres para Oracle Standard Edition 2 a nivel de base de datos sin licenciamiento adicional de Oracle (Active Data Guard requiere Oracle Enterprise Edition).

PodHeitor incluye:

mode=cdp — un daemon que envía continuamente archivelogs al almacenamiento de Bacula, proporcionando un RPO de minutos en lugar de horas.
mode=replicate con replicate_method=archivelog_apply — un canal de replicación DR que funciona con Oracle Standard Edition 2, Oracle Express Edition y Oracle 23ai FREE, sin requerir licencia de Active Data Guard.

3. Descripción General de la Solución

Qué Ofrece el Plugin

El Plugin de Backup OracleDB de PodHeitor integra PodHeitor Backup con Oracle RMAN mediante una implementación de sala limpia de la API Oracle SBT v2 (libobk-rs.so), ofreciendo cinco modos de backup diferenciados, restauración totalmente automatizada y replicación DR nativa — todo desde un único paquete RPM de 622 KB.

Cinco Modos de Backup

Modo	Descripción	Requisito Oracle	Staging Requerido
`rman_sbt`	RMAN sin staging vía SBT v2 (`libobk-rs`). Recomendado para producción.	11g R2+	Ninguno — transmisión directa
`rman`	RMAN escribe en staging local; el backend transmite a Bacula.	11g R2+	Sí — disco temporal
`dump`	Backup lógico con Oracle Data Pump (`expdp` / `impdp`).	11g R2+ (`exp` en 11g)	Sí — disco temporal
`cdp`	Daemon continuo de archivelogs. Protección de bajo RPO.	11g R2+	Ninguno
`replicate`	Replicación DR mediante Active DG duplicate o archivelog-apply.	SE2 o EE	Opcional

Descripción General de la Arquitectura

┌─────────────────────────────────────────────────────────────┐
│                      Bacula Director                        │
│  • Schedules jobs          • Stores RestoreObjects          │
│  • Manages catalog         • Issues bconsole commands       │
└─────────────────────────┬───────────────────────────────────┘
                          │ TCP (Bacula Protocol)
┌─────────────────────────▼───────────────────────────────────┐
│               Bacula File Daemon (FD 15.0.3+)               │
│  • Loads podheitor-oracle-fd.so via plugin API              │
│  • Dispatches bEventBackupCommand / bEventRestoreObject     │
└─────────────────────────┬───────────────────────────────────┘
                          │ PTCOMM (fork + pipe)
┌─────────────────────────▼───────────────────────────────────┐
│          podheitor-oracle-backend (Rust, musl static-pie)   │
│  • Backup dispatcher  • Restore engine  • CDP daemon        │
│  • Metrics (Prometheus) • Canary sampler • Audit logger     │
└────────────┬──────────────────────────────────┬────────────┘
             │ subprocess + UNIX socket          │ subprocess
┌────────────▼────────────┐       ┌─────────────▼───────────┐
│  RMAN (SBT mode)        │       │ sqlplus / expdp / dbv   │
│  → libobk-rs.so (SBT v2)│       │ (non-SBT modes)         │
│  → UNIX socket back     │       │                         │
│    to backend           │       │                         │
└─────────────────────────┘       └─────────────────────────┘
             │
┌────────────▼────────────┐
│    Oracle Database      │
│   (11g R2 → 23ai)       │
└─────────────────────────┘

Automatización de Restauración mediante RestoreObject

Cada backup incluye un RestoreObject pluginrestoreconf en el catálogo de Bacula. En el momento de la restauración, el operador selecciona una acción en bconsole o en el formulario web de Bacularis — no se requiere SSH al host Oracle. El plugin valida la configuración, genera el script RMAN apropiado, ejecuta opcionalmente un RESTORE PREVIEW, lleva a cabo la restauración y escribe un manifiesto post-restauración en el catálogo.

Replicación DR — Nativa

mode=replicate con replicate_method=archivelog_apply crea una base de datos en standby mediante:

Ejecución de RMAN DUPLICATE para crear la copia inicial en standby.
Envío y aplicación continua de archivelogs al host standby.

Esto proporciona una protección equivalente a Active Data Guard sin requerir licencia de Oracle Enterprise Edition — una capacidad ausente en todos los productos competidores mencionados en este whitepaper.

4. Arquitectura

4.1 Diagrama de Componentes

┌─────────────────────────────────────────────────────────────────────────┐
│  PodHeitor Backup INFRASTRUCTURE                                        │
│                                                                         │
│  ┌────────────────┐   TCP/TLS    ┌──────────────────────────────────┐  │
│  │ bacula-dir     │◄────────────►│ bacula-fd 15.0.3                 │  │
│  │ (Director)     │              │                                  │  │
│  │ • Catalog DB   │              │  ┌────────────────────────────┐  │  │
│  │ • Scheduler    │              │  │ podheitor-oracle-fd.so     │  │  │
│  │ • RestoreObjs  │              │  │ (C++ thin shim, ~3 KB)     │  │  │
│  └────────────────┘              │  │ • Bacula Plugin API        │  │  │
│                                  │  │ • fork() + pipe()          │  │  │
│  ┌────────────────┐   TCP/TLS    │  │ • PTCOMM encode/decode     │  │  │
│  │ bacula-sd      │◄────────────►│  └──────────┬─────────────────┘  │  │
│  │ (Storage)      │              │             │ PTCOMM              │  │
│  └────────────────┘              │  ┌──────────▼─────────────────┐  │  │
│                                  │  │ podheitor-oracle-backend    │  │  │
│                                  │  │ (Rust, x86_64-musl, static) │  │  │
│                                  │  │                             │  │  │
│                                  │  │  backup::run()              │  │  │
│                                  │  │    ├── run_dump()           │  │  │
│                                  │  │    ├── run_rman()           │  │  │
│                                  │  │    ├── run_rman_sbt()       │  │  │
│                                  │  │    ├── run_cdp()            │  │  │
│                                  │  │    └── run_replicate()      │  │  │
│                                  │  │                             │  │  │
│                                  │  │  restore::run()             │  │  │
│                                  │  │    └── run_rman_restore()   │  │  │
│                                  │  │                             │  │  │
│                                  │  │  oracle::sbt_server         │  │  │
│                                  │  │  oracle::audit              │  │  │
│                                  │  │  oracle::canary             │  │  │
│                                  │  │  metrics::http_server       │  │  │
│                                  │  └──────────┬─────────────────┘  │  │
│                                  └─────────────┼──────────────────── ┘  │
└────────────────────────────────────────────────┼────────────────────────┘
                                                 │
                        ┌────────────────────────┼──────────────────────┐
                        │  Oracle Host            │                      │
                        │                         │ UNIX socket          │
                        │  ┌──────────────────────▼──────────────────┐  │
                        │  │ /var/run/podheitor-oracle/<SID>.sock     │  │
                        │  └──────────────────────┬──────────────────┘  │
                        │                         │ SBT v2              │
                        │  ┌──────────────────────▼──────────────────┐  │
                        │  │ libobk-rs.so (clean-room SBT v2 plugin nativo) │  │
                        │  │ symlinked as $ORACLE_HOME/lib/libobk.so  │  │
                        │  └──────────────────────┬──────────────────┘  │
                        │                         │ SBT v2              │
                        │  ┌──────────────────────▼──────────────────┐  │
                        │  │ RMAN (Oracle Recovery Manager)           │  │
                        │  │ N channels, parallel streams             │  │
                        │  └──────────────────────┬──────────────────┘  │
                        │                         │                     │
                        │  ┌──────────────────────▼──────────────────┐  │
                        │  │ Oracle Database (SID=<SID>)              │  │
                        │  │ • Datafiles • Archivelogs • Controlfile  │  │
                        │  │ • SPFILE • TDE Wallet • PDBs             │  │
                        │  └─────────────────────────────────────────┘  │
                        └──────────────────────────────────────────────┘

4.2 mode=rman_sbt Flujo de Datos (Sin Staging, Recomendado)

4.3 mode=cdp — Bucle del Daemon de Protección de Datos Continua

4.4 Flujo de Restauración — RestoreObject → RMAN

4.5 Decisiones Tecnológicas

Componente	Tecnología	Justificación
Binario backend	Rust 2021, musl static-pie	Seguridad de memoria, sin dependencias en tiempo de ejecución, implementación en un solo archivo
Shim FD	C++ (Bacula Plugin API)	Bacula requiere un ABI de plugin C/C++
Protocolo IPC	PTCOMM (binario, fork+pipe)	Sin sobrecarga de socket de red; enmarcado determinista
Implementación SBT	`libobk-rs` (plugin nativo Rust de sala limpia)	Proprietary; sin código propietario de Oracle linkado
IPC SBT ↔ backend	UNIX socket `/var/run/podheitor-oracle/<SID>.sock`	Baja latencia, mismo host, aislamiento por SID
Persistencia de estado	Archivos JSON, `/opt/bacula/working/oracle-state/<SID>/`	Legible por humanos, escritura atómica con renombre
Observabilidad	Formato texto Prometheus, TCP stdlib	Endpoint nativo, sin dependencias externas
Limitación de I/O	cgroups v2 `io.max`	Aplicado por el kernel, sin conjeturas sobre la tasa de RMAN
Licencia	PodHeitor-Proprietary	Copyright © Heitor Faria — All rights reserved

5. Tabla Comparativa de Funcionalidades

La siguiente tabla compara PodHeitor v1.0.0 con Bacula Enterprise 18.2.3, Veeam Backup & Replication for Oracle, Commvault IntelliSnap Oracle y NetBackup for Oracle.

Leyenda: Y = Sí/Soportado | N = No/No soportado | M = Manual/Requiere pasos adicionales | P = Parcial | EE = Requiere Oracle Enterprise Edition

5.1 Modos de Backup

Funcionalidad	Bacula Enterprise 18.2.3	Veeam	Commvault	NetBackup	PodHeitor 1.0.0
RMAN SBT v2 (sin staging)	Y (libobk.so propietaria)	N	N	Y (nbora)	Y (libobk-rs.so de sala limpia, Proprietary)
RMAN sin SBT (con staging)	Y	N	P	P	Y + opción FIFO sin staging
Data Pump (`expdp`)	P (vía dump_pump_opt)	N	N	N	Y (predeterminado en 12c+)
exp legado (11g)	Y	N	N	N	Y
Archivelog continuo (CDP)	N	N	N	N	Y (modo daemon, mode=cdp)
Replicación DR (compatible SE2)	N	N	N	N	Y (archivelog_apply)
Active DG duplicate	N (licencia sep.)	N	N	EE	Y (duplicate_active, sin licencia adicional)

5.2 Backup Incremental y Avanzado

Funcionalidad	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Incremental Nivel 0/1 RMAN	Y	Y	Y	Y	Y
Incremental FROM SCN	Y	N	N	P	Y + detector de brecha SCN + reanudación
Block Change Tracking	Y (manual)	Y	Y	Y	Y (habilitación automática + verificación de integridad)
Backup de archivelogs	Y	Y	Y	Y	Y
Autobackup de controlfile	Y	Y	Y	Y	Y
Backup de SPFILE / pfile / orapw	Y	N	N	P	Y
Multicanal en paralelo	Y (ALLOCATE manual)	Y	Y	Y	Y (ajuste automático por núcleos CPU/IOPS)
Checkpoint / reanudación	N	N	N	N	Y (ADR-014, cadena SCN)
Política de eliminación de archivelogs	N	N	N	N	Y (archivelog_keep_backed_up=N)
Snapshot AWR al final del Full	N	N	N	N	Y (awr_snapshot=yes)

5.3 Topología y Multitenant

Funcionalidad	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Oracle 11g R2	Y	N	P	Y	Y
Oracle 12c / 18c / 19c / 21c	Y	Y	Y	Y	Y
Oracle 23ai	P	P	N	P	Y (validado en producción)
Autodescubrimiento RAC	M	N	Y	Y	Y (automático + paralelo por nodo)
Multitenant CDB/PDB	Y (implícito)	Y	Y	Y	Y (paralelo por PDB + selectivo)
Puerta de rol Data Guard	Y (implícito)	N	P	Y	Y (prefer_standby=no/yes/auto)
Manejo de rutas ASM	Y	Y	Y	Y	Y (resolución asmcmd + filtro dbv)
Restauración entre arquitecturas (Solaris→Linux)	M (manual)	N	N	P	Y (RMAN CONVERT DATAFILE automático)
Backup de wallet TDE	Y	P	P	P	Y (con conciencia de rotación de clave maestra)

5.4 Automatización de Restauración

Funcionalidad	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Restauración sin SSH al host Oracle	N	N	N	N	Y (solo bconsole)
Pista de auditoría en catálogo Bacula	N	N	N	N	Y (JobLog completo + manifiesto)
PITR (recuperación a punto en el tiempo)	M (script perl)	M	M	M	Y (1 paso, action=pitr)
Restauración basada en SCN	M	N	N	M	Y (1 paso, action=scn)
Recuperación a nivel de tabla (12c+)	M	N	N	M	Y (1 paso, action=table)
Clonación a host/SID diferente	M (beta)	M	M	M	Y (action=clone)
RESTORE PREVIEW antes de ejecutar	N	N	N	N	Y (preview_first=yes)
VALIDATE DATABASE tras restauración	N	N	N	N	Y (verify_after=yes)
Modo de prueba en seco	N	N	N	N	Y (dry_run=yes)
Flashback Database	N	N	N	N	Y (action=flashback)
Formulario web Bacularis para restauración	N	N/A	N/A	N/A	Y (integración nativa con Bacularis)

5.5 Compresión y Limitación de Ancho de Banda

Funcionalidad	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
RMAN BASIC/MEDIUM/HIGH	Y	Y	Y	Y	Y
zstd / lz4 pre-SBT pipe	N	N	N	N	Y (opción de doble compresión)
Limitación RMAN RATE	Y	Y	Y	Y	Y
Limitación I/O cgroups v2	N	N	N	N	Y (cgroup_write_bps=)

5.6 Observabilidad y Cadena de Suministro

Funcionalidad	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Endpoint Prometheus /metrics	N	N	N	N	Y (metrics_addr=host:port)
Canary anti-ransomware	N	Y (separado)	Y (separado)	Y (separado)	Y (integrado, muestreo de hash de bloque)
Redacción de credenciales en log de auditoría	N	N	N	N	Y (contraseñas/claves nunca aparecen en logs)
DBVERIFY post-restauración	N	N	N	N	Y (automatizado)
Verificación previa en modo prueba seca	N	N	N	N	Y (indicador –dry-run)
Builds reproducibles	N (propietario)	N	N	N	Y (musl static-pie, Cargo.lock)
SBOM (CycloneDX)	N	N	N	N	Y (make sbom)
Auditoría CVE (cargo-audit + cargo-deny)	N	N	N	N	Y (0 CVEs, 78 dependencias crate)

6. Referencia de Opciones de Backup

Todos los parámetros se especifican en la directiva Plugin = de Bacula dentro de un bloque FileSet. Los parámetros también pueden colocarse en el archivo de configuración (predeterminado: /opt/bacula/etc/podheitor-oracle.conf) como líneas clave=valor — los parámetros de la línea del plugin siempre prevalecen sobre los valores del archivo de configuración.

6.1 Conexión e Identidad

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`sid`	string	`*` (todos los detectados)	Oracle SID (nombre de instancia). Use `*` para detectar automáticamente todas las instancias en ejecución.	1.0.0
`oracle_home`	ruta	`auto`	Ruta `$ORACLE_HOME`. `auto` lee desde `/etc/oratab` u `oraenv`.	1.0.0
`oracle_user`	string	`/ as sysdba`	Usuario del sistema operativo con el que conectarse. Establezca `oracle` para autenticación del SO.	1.0.0
`unix_user`	string	`oracle`	Cuenta del SO a la que cambia el backend antes de lanzar RMAN/sqlplus.	1.0.0
`use_sudo`	bool	`no`	Prefija los comandos oracle con `sudo -u <unix_user>` en lugar de setuid.	1.0.0
`auth`	`os`	`pwfile:<path>`	`walletconn:<alias>`	`os`	Método de autenticación. `os` = `/ as sysdba`. `pwfile:` = archivo de contraseña. `walletconn:` = alias TNS de Oracle Wallet.	1.0.0
`config_file`	ruta	`/opt/bacula/etc/podheitor-oracle.conf`	Ruta alternativa al archivo de configuración.	1.0.0
`instance`	string	`*`	Filtro de instancia RAC. `*` = todas las instancias.	1.0.0
`verbose`	0–3	`0`	Nivel de detalle en el log de Job de Bacula.	1.0.0
`debug`	0–9	`0`	Nivel de depuración; ≥5 habilita volcados de frame PTCOMM.	1.0.0
`trace`	ruta	«	Escribe el log de trazas en un archivo (además del log de Job de Bacula).	1.0.0

6.2 Modo de Backup

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`mode`	`rman_sbt`	`rman`	`dump`	`cdp`	`replicate`	`dump`	Modo de backup. `rman_sbt` es el recomendado para producción.	1.0.0

6.3 Opciones RMAN (aplicables a mode=rman y mode=rman_sbt)

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`channels`	`auto`	1–64	`auto`	Número de canales de backup RMAN. `auto` se ajusta al número de núcleos CPU.	1.0.0
`auto_tune_channels`	bool	`yes`	Cuando `channels=auto`, ajusta dinámicamente el número de canales según los núcleos disponibles.	1.0.0
`bct`	`auto`	`on`	`off`	`auto`	Block Change Tracking. `auto` lo habilita si no está habilitado.	1.0.0
`archivelog`	`include`	`exclude`	`only`	`include`	Manejo de archivelogs. `include` = respaldar después de los datafiles. `only` = backup solo de archivelogs.	1.0.0
`archivelog_keep_backed_up`	0–99	`0`	Elimina archivelogs del FRA después de N copias de backup. 0 = deshabilitado.	1.0.0
`max_rate_mb`	0–99999	`0` (sin límite)	Límite de velocidad por canal RMAN en MB/seg. 0 = sin límite (use `cgroup_write_bps` para limitación basada en cgroups).	1.0.0
`ctrlfile`	ruta	`/tmp/oracle`	Prefijo de ruta de staging para el autobackup del controlfile.	1.0.0
`hooks_dir`	ruta	`/opt/bacula/etc`	Directorio analizado en busca de scripts hook `oracle_before_.rman` / `oracle_after_.rman`.	1.0.0

6.4 Compresión

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`compress`	`none`	`zstd`	`lz4`	`gzip`	`rman_basic`	`rman_medium`	`rman_high`	`zstd`	Algoritmo de compresión. `rman_*` usa compresión nativa RMAN dentro del bloque RMAN. `zstd`/`lz4`/`gzip` aplica compresión a nivel de pipe antes de enviar a Bacula.	1.0.0
`compress_level`	1–22 (zstd), 1–9 (gzip)	`3`	Nivel de compresión (aplica solo a zstd y gzip).	1.0.0

6.5 Canales y Paralelismo

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`parallel_dbs`	1–64	`4`	Máximo de bases de datos a respaldar en paralelo (cuando `sid=*`).	1.0.0
`parallel_pdbs`	1–64	`4`	Máximo de PDBs a respaldar en paralelo dentro de un CDB.	1.0.0
`parallel_nodes`	0–64	`0` (todos)	Máximo de nodos RAC a usar concurrentemente. 0 = todos los descubiertos.	1.0.0
`prefer_standby`	`no`	`yes`	`auto`	`no`	Puerta de rol Data Guard. `no` = backup solo en PRIMARY. `yes` = requerir standby físico. `auto` = ejecutar en cualquier rol con capacidad física.	1.0.0

6.6 Multitenant (CDB/PDB)

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`pdbs`	`*`	nombres separados por coma	`*`	Filtro de nombre de PDB. `*` = todos los PDBs. Ejemplo: `pdbs=PDB1,PDB2`.	1.0.0
`pdb_skip_seed`	bool	`yes`	Omite `PDB$SEED` (el PDB semilla de solo lectura) en los backups multitenant.	1.0.0
`exclude_tablespace`	nombres separados por coma	«	Nombres de tablespace a excluir del backup.	1.0.0
`exclude_pdb`	nombres separados por coma	«	Nombres de PDB a excluir del backup.	1.0.0

6.7 Wallet TDE

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`wallet_backup`	bool	`yes`	Incluye el backup del wallet TDE en el Job.	1.0.0
`wallet_path`	ruta	`auto`	`auto`	Ruta al directorio de Oracle Wallet. `auto` lee desde `sqlnet.ora`.	1.0.0
`wallet_passphrase_file`	ruta	«	Archivo que contiene la frase de contraseña para abrir el wallet. Los permisos deben ser 600.	1.0.0

6.8 Data Pump (mode=dump)

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`dump_format`	`expdp`	`exp`	`expdp`	Usa Data Pump (`expdp`) o exportación legada (`exp`). Forzado a `exp` en 11g.	1.0.0
`dump_opt`	string	`CONSISTENT=Y GRANTS=y`	Opciones adicionales añadidas a la línea de comandos de `exp`.	1.0.0
`dump_pump_opt`	string	«	Opciones adicionales añadidas al parfile de `expdp` (p. ej. `EXCLUDE=STATISTICS`).	1.0.0
`schema`	`*`	separados por coma	`*`	Filtro de schema (propietario) para la exportación con Data Pump. `*` = todos los schemas.	1.0.0

6.9 Protección de Datos Continua (mode=cdp)

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`cdp_poll_interval`	1–3600 (segundos)	`5`	Frecuencia (en segundos) con la que el daemon CDP consulta `v$archived_log` en busca de nuevos logs.	1.0.0
`cdp_max_lag`	1–86400 (segundos)	`300`	Umbral de alarma de RPO en segundos. Activa `PODHEITOR-ORACLE-AUDIT kind=cdp_lag_exceeded` cuando se supera.	1.0.0

6.10 Replicación (mode=replicate)

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`replicate_method`	`duplicate_active`	`archivelog_apply`	`duplicate_active`	`duplicate_active` = RMAN DUPLICATE FROM ACTIVE DATABASE (EE). `archivelog_apply` = bootstrap + aplicación continua de logs (compatible con SE2).	1.0.0
`target_sid`	string	«	SID de la base de datos standby (requerido para el modo replicate).	1.0.0
`target_host`	string	«	FQDN o IP del host standby.	1.0.0
`target_oracle_home`	ruta	«	`$ORACLE_HOME` en el host standby.	1.0.0

6.11 Validación (verificación de integridad post-backup)

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`validate_after`	bool	`yes`	Ejecuta `RMAN VALIDATE BACKUPSET` al finalizar cada Job de backup.	1.0.0

6.12 Canary Anti-Ransomware

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`canary`	bool	`no`	Habilita el canary de muestreo de hash de bloque. Detecta cambios masivos en datafiles entre ejecuciones de backup.	1.0.0
`canary_blocks`	1–4096	`64`	Número de bloques aleatorios muestreados por datafile en cada verificación canary.	1.0.0
`canary_threshold_pct`	1–100	`25`	Porcentaje de bloques modificados que activa un mensaje `PODHEITOR-ORACLE-CANARY-ALERT`.	1.0.0

6.13 Observabilidad

Parámetro	Tipo / Valores Válidos	Predeterminado	Descripción	Desde
`metrics_addr`	`host:port`	`0`	`0` (deshabilitado)	Dirección de enlace para el endpoint HTTP `/metrics` de Prometheus. Ejemplo: `0.0.0.0:9119`.	1.0.0
`cgroup_write_bps`	0–(uint64)	`0` (deshabilitado)	Limitación de escritura I/O cgroups v2 en bytes/seg. Requiere que el proceso backend esté en una jerarquía cgroup v2.	1.0.0
`awr_snapshot`	bool	`no`	Crea un snapshot AWR al final de cada backup Full y escribe el informe de rendimiento HTML en el directorio de estado. No es fatal en XE/SE2.	1.0.0
`goldengate_aware`	bool	`no`	Detecta procesos GoldenGate activos y emite su checkpoint de SCN antes de cada backup.	1.0.0

6.14 Hooks

Los archivos hook se colocan en hooks_dir (predeterminado /opt/bacula/etc). El backend analiza los archivos que coinciden con estos patrones antes y después de la ejecución de RMAN:

Archivo Hook	Disparador	Notas
`oracle_before_full_backup.rman`	Antes del backup Full RMAN	Nomenclatura compatible con Enterprise
`oracle_after_full_backup.rman`	Después del backup Full RMAN	Extensión: los hooks after son exclusivos de PodHeitor
`oracle_before_incremental_backup.rman`	Antes del backup Incremental
`oracle_after_incremental_backup.rman`	Después del backup Incremental
`oracle_before_full_backup_<SID>.rman`	Antes del Full — específico por SID	Tiene prioridad sobre el hook genérico
`oracle_after_full_backup_<SID>.rman`	Después del Full — específico por SID

7. Referencia de Opciones de Restauración

Las opciones de restauración se entregan mediante el RestoreObject pluginrestoreconf, que queda embebido en cada backup y se presenta como prompts interactivos en bconsole o como formulario en Bacularis. Las claves siguen la sintaxis INI clave = valor con comentarios mediante #.

7.1 Campos Principales (todas las acciones)

Clave	Tipo / Valores válidos	Predeterminado	Descripción
`action`	`pitr`	`scn`	`table`	`clone`	`full`	`preview`	`validate`	`flashback`	`preview`	Acción de restauración a ejecutar. Requerido.
`auto_open_resetlogs`	bool	`yes`	Emite automáticamente `ALTER DATABASE OPEN RESETLOGS` tras RECOVER DATABASE.
`shutdown_if_open`	bool	`yes`	Emite `SHUTDOWN IMMEDIATE` antes de la restauración si la base de datos está abierta.
`parallelism`	`auto`	1–64	`auto`	Número de canales de restauración RMAN. `auto` iguala el número de canales del backup original.
`verify_after`	bool	`yes`	Ejecuta `RMAN VALIDATE DATABASE CHECK LOGICAL` + DBVERIFY después de la restauración.
`preview_first`	bool	`no`	Ejecuta `RESTORE DATABASE PREVIEW` antes de efectuar la restauración. Genera un plan sin modificar la base de datos.
`require_explicit_confirmation`	bool	`yes`	Para acciones destructivas, solicita al operador escribir `yes` en bconsole antes de continuar.
`dry_run`	bool	`no`	Analiza y valida la configuración, genera el script RMAN, lo imprime en el log del job, pero no lo ejecuta.