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

Backup Oracle Database integrado com RMAN. Hot backup, archive log streaming, PITR ao SCN, suporte a Data Guard primário/standby, RAC e PDB multi-tenant.

Integração RMAN nativa — controle de catálogo, validação BLOCKRECOVER automática.
Archive log streaming contínuo — RPO próximo de zero.
PITR ao SCN — restauração precisa por número de transação Oracle.
Data Guard-aware — backup do standby, zero overhead no primário.
RAC e Multi-tenant (PDB) — backup individual de PDB, restore para CDB diferente.

Comece em 30 dias, no mínimo 50% mais barato. Trial gratuito, RPMs e DEBs assinados, suporte direto com Heitor Faria. Substitua sua licença Veeam, Commvault ou Bacula Enterprise sem quebrar a janela noturna.

Solicitar trial gratuito de 30 dias →

OFERTA COMERCIAL — LEIA PRIMEIRO

Migrando do Bacula Enterprise, Veeam, Commvault ou NetBackup? Traga sua proposta de renovação ou contrato vigente e garantimos no mínimo 50% de desconto — com significativamente mais recursos incluídos.

Índice

Sumário Executivo
O Problema
Visão Geral da Solução
Arquitetura
Tabela Comparativa de Recursos
Referência de Opções de Backup
Referência de Opções de Restauração
Exemplos de Configuração de FileSet
Exemplos de Job de Restauração
Guia de Instalação e Dimensionamento
Matriz de Compatibilidade
Relatório de Desempenho
Segurança e Conformidade
Suporte e Termos Comerciais
Apêndice A — Registros de Decisão de Arquitetura
Apêndice B — Glossário

1. Sumário Executivo

O Que É?

O PodHeitor OracleDB Backup and Replication Plugin for PodHeitor Backup é um plugin de nível produção para o Bacula File Daemon que oferece proteção abrangente para bancos de dados Oracle — desde backups a quente via RMAN SBT v2 até proteção contínua de dados (CDP) e replicação nativa para recuperação de desastres — a uma fração do custo das alternativas proprietárias.

Escrito inteiramente em Rust (construído em Rust com segurança de memória nativa e zero dependências de runtime), o plugin é distribuído como um único pacote RPM ou DEB (menos de 700 KB instalado) e não requer bibliotecas de terceiros específicas para Oracle, implementações proprietárias de SBT nem scripts shell externos ao Bacula.

Valor de Negócio em Três Pontos

Redução de Custo de 50% ou Mais. O backup de bancos de dados Oracle é um dos itens mais caros no orçamento de TI de qualquer empresa. O Bacula Enterprise cobra taxas de licenciamento por cliente ou por agente que se acumulam a cada instância Oracle protegida. Veeam, Commvault e NetBackup somam licenças de agente, módulos adicionais e manutenção anual. O PodHeitor entrega todas as capacidades dessas plataformas — e várias que elas não possuem — sob PodHeitor-Proprietary, eliminando completamente a cobrança por socket ou por TB.

Mais Recursos, Não Menos. Esta não é uma alternativa open-source limitada. O plugin supera o Bacula Enterprise 18.2.3 em proteção contínua de dados (modo daemon CDP), replicação nativa de DR para Standard Edition 2 (archivelog-apply), observabilidade Prometheus/OpenTelemetry, detecção de canário anti-ransomware, validação automatizada pós-restauração com DBVERIFY e integridade da cadeia de suprimentos via CycloneDX SBOM. O Bacula Enterprise não possui nenhum desses recursos.

Automação de Restauração Nativa no Bacula. Os produtos concorrentes exigem que o operador acesse via SSH o host Oracle e invoque um script Perl (bs_oracle_restore.pl) ou equivalente fora de qualquer trilha de auditoria. O PodHeitor utiliza o mecanismo nativo RestoreObject do Bacula: um documento pluginrestoreconf embutido em cada backup dispara uma restauração totalmente automatizada e catalogada diretamente a partir do bconsole ou do console web Bacularis. Não é necessário acesso SSH ao host Oracle.

Para Quem É Este Documento

DBAs Oracle avaliando estratégias de backup para cargas de trabalho das versões 11g a 23ai.
Administradores Bacula que desejam substituir um plugin Oracle comercial sem reformular sua infraestrutura.
Arquitetos de Infraestrutura projetando pipelines de recuperação de desastres e replicação de dados para ambientes Oracle Standard Edition 2 ou Enterprise Edition.
Equipes de Compras de TI comparando custos de licença e paridade de recursos com Bacula Enterprise, Veeam for Oracle, Commvault IntelliSnap Oracle e NetBackup for Oracle.

2. O Problema

O Backup Oracle É Excepcionalmente Complexo

O backup do Oracle Database é diferente de fazer backup de um sistema de arquivos ou de um banco de dados relacional simples. Um backup Oracle correto deve considerar:

Consistência de SCN — backups que abrangem múltiplos datafiles devem ser consistentes no mesmo System Change Number, caso contrário produzem um conjunto irrecuperável.
Integridade da cadeia de archivelog — a recuperação pontual (point-in-time) exige uma sequência ininterrupta de redo logs arquivados desde o último backup Full até o momento-alvo.
Controlfile e SPFILE — o banco de dados não pode ser montado sem eles; devem ser copiados atomicamente junto com cada backup de datafile.
Multitenant (CDB/PDB) — o Oracle 12c e versões posteriores permitem centenas de bancos de dados plugáveis dentro de um contêiner; a estratégia de backup deve tratar tanto o contêiner raiz quanto os PDBs individuais de forma independente.
Criptografia TDE — os wallets de Transparent Data Encryption devem ser copiados e rotacionados de forma coordenada, caso contrário a restauração torna-se impossível.
ASM e RAC — a Grid Infrastructure adiciona abstração de armazenamento (ASM) e paralelismo de cluster (RAC) que ferramentas de backup genéricas não conseguem enxergar.

O RMAN (Recovery Manager) é o mecanismo de backup nativo do Oracle e a única ferramenta que atende completamente a todos esses requisitos. Qualquer solução de backup Oracle séria deve se integrar ao RMAN em profundidade — não executando rman target / e arquivando os arquivos de saída como se fossem objetos arbitrários do sistema de arquivos.

O Problema de Custo

Produto	Custo Típico de Backup Oracle	Observações
Bacula Enterprise	US$ 3.000–US$ 8.000 / ano por host Oracle	Módulo Oracle adicional sobre a licença base do FD
Veeam for Oracle	US$ 2.500–US$ 6.000 / ano por socket	Requer Veeam Backup & Replication Enterprise Plus
Commvault IntelliSnap Oracle	US$ 5.000–US$ 15.000 / ano por host	Licença de agente + IntelliSnap
NetBackup for Oracle	US$ 4.000–US$ 12.000 / ano por host	Licença NBU Client + DB Agent
PodHeitor	Taxa fixa por organização (sem custo por host)	Suporte comercial disponível com o autor

Os valores indicados são baseados em preços de tabela publicamente disponíveis e relatos da comunidade até 2026. Os preços negociados reais variam. O fato permanece: para uma organização que protege 10 hosts Oracle, a economia anual em comparação com qualquer solução proprietária varia de US$ 25.000 a US$ 150.000.

O Problema de Restauração — O Custo Oculto

O custo das ferramentas proprietárias de backup Oracle não se resume à taxa de licença. O custo oculto está na complexidade da restauração.

O Bacula Enterprise 18.2.3 inclui um script Perl chamado bs_oracle_restore.pl. Para realizar uma recuperação pontual, o DBA deve:

Acessar via SSH o host Oracle (requer acesso ao sistema operacional, VPN e gerenciamento de chaves).
Localizar a versão correta do bs_oracle_restore.pl (que muda entre versões do Bacula).
Executar o script com os parâmetros corretos — uma dúzia de flags sem validação interativa.
Torcer para que o script gere os comandos RMAN corretos para o timestamp-alvo.
Monitorar o progresso diretamente no host Oracle — sem entrada no catálogo Bacula para a operação de restauração.
Abrir manualmente o banco de dados com RESETLOGS caso o script não o faça automaticamente.

Esse fluxo de trabalho é propenso a erros, impossível de auditar e requer acesso no nível do sistema operacional que a maioria das políticas de segurança proíbe conceder a DBAs da camada de aplicação.

O PodHeitor elimina tudo isso. Todo o fluxo de restauração — incluindo PITR, baseado em SCN, recuperação em nível de tabela, clone e ações de validação — é conduzido a partir do bconsole ou do formulário web Bacularis, com trilha de auditoria completa no catálogo Bacula, sem nenhum acesso SSH ao host Oracle.

A Lacuna em Replicação e CDP

Nenhum dos quatro principais produtos concorrentes (Bacula Enterprise, Veeam, Commvault, NetBackup) inclui proteção contínua de dados (CDP) nativa ou replicação para recuperação de desastres em Oracle Standard Edition 2 no nível do banco de dados, sem licenciamento Oracle adicional (o Active Data Guard requer Oracle Enterprise Edition).

O PodHeitor inclui:

mode=cdp — um daemon que envia continuamente archivelogs para o armazenamento Bacula, entregando RPO em minutos em vez de horas.
mode=replicate com replicate_method=archivelog_apply — um canal de replicação de DR que funciona com Oracle Standard Edition 2, Oracle Express Edition e Oracle 23ai FREE, sem necessidade de licença Active Data Guard.

3. Visão Geral da Solução

O Que o Plugin Oferece

O PodHeitor OracleDB Backup Plugin integra o PodHeitor Backup ao Oracle RMAN por meio de uma implementação clean-room da API Oracle SBT v2 (libobk-rs.so), entregando cinco modos distintos de backup, restauração totalmente automatizada e replicação nativa de DR — tudo em um único pacote RPM de 622 KB.

Cinco Modos de Backup

Modo	Descrição	Requisito Oracle	Staging Necessário
`rman_sbt`	RMAN via SBT v2 sem staging (`libobk-rs`). Recomendado para produção.	11g R2+	Nenhum — transmite diretamente
`rman`	RMAN grava em staging local; backend transmite para o Bacula.	11g R2+	Sim — disco temporário
`dump`	Backup lógico via Oracle Data Pump (`expdp` / `impdp`).	11g R2+ (`exp` no 11g)	Sim — disco temporário
`cdp`	Daemon de archivelog contínuo. Proteção com baixo RPO.	11g R2+	Nenhum
`replicate`	Replicação de DR via Active DG duplicate ou archivelog-apply.	SE2 ou EE	Opcional

Visão Geral da Arquitetura

┌─────────────────────────────────────────────────────────────┐
│                      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)       │
└─────────────────────────┘

Automação de Restauração via RestoreObject

Cada backup incorpora um RestoreObject pluginrestoreconf no catálogo Bacula. No momento da restauração, o operador seleciona uma ação no bconsole ou no formulário web Bacularis — não é necessário acesso SSH ao host Oracle. O plugin valida a configuração, gera o script RMAN apropriado, opcionalmente executa um RESTORE PREVIEW, realiza a restauração e registra um manifesto pós-restauração no catálogo.

Replicação de DR — Nativa

mode=replicate com replicate_method=archivelog_apply cria um banco de dados standby ao:

Executar RMAN DUPLICATE para criar a cópia standby inicial.
Enviar e aplicar continuamente archivelogs ao host standby.

Isso fornece proteção equivalente ao Active Data Guard sem licenciamento Oracle Enterprise Edition — uma capacidade ausente em todos os produtos concorrentes listados neste whitepaper.

4. Arquitetura

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 Fluxo de Dados mode=rman_sbt (Zero-Staging, Recomendado)

No modo rman_sbt, o RMAN transmite dados diretamente para o Bacula Storage via canal interno otimizado — sem disco temporário necessário. O backend gerencia os canais RMAN em paralelo, com compressão integrada antes da transmissão.

4.3 mode=cdp — Loop do Daemon de Proteção Contínua de Dados

4.4 Fluxo de Restauração — RestoreObject → RMAN

4.5 Escolhas Tecnológicas

Componente	Tecnologia	Justificativa
Binário backend	Rust 2021, musl static-pie	Segurança de memória, zero dependências em tempo de execução, implantação em arquivo único
Shim do FD	C++ (Bacula Plugin API)	O Bacula exige um ABI de plugin C/C++
Protocolo IPC	PTCOMM (binário, fork+pipe)	Sem overhead de socket de rede; enquadramento determinístico
Implementação SBT	`libobk-rs` (Rust plugin nativo clean-room)	Proprietário; reimplementação clean-room da API SBT Oracle
IPC SBT ↔ backend	UNIX socket `/var/run/podheitor-oracle/<SID>.sock`	Baixa latência, mesmo host, isolamento por SID
Persistência de estado	Arquivos JSON, `/opt/bacula/working/oracle-state/<SID>/`	Legível por humanos, gravação atômica com rename
Observabilidade	Formato texto Prometheus, TCP stdlib	Endpoint nativo, sem dependências externas
Throttle de I/O	cgroups v2 `io.max`	Imposto pelo kernel, sem estimativas de taxa RMAN
Licença	PodHeitor-Proprietary	Copyright © Heitor Faria — All rights reserved

5. Tabela Comparativa de Recursos

A tabela a seguir compara o PodHeitor v1.0.0 com Bacula Enterprise 18.2.3, Veeam Backup & Replication for Oracle, Commvault IntelliSnap Oracle e NetBackup for Oracle.

Legenda: S = Sim/Suportado | N = Não/Não suportado | M = Manual/Requer etapas extras | P = Parcial | EE = Requer Oracle Enterprise Edition

5.1 Modos de Backup

Recurso	Bacula Enterprise 18.2.3	Veeam	Commvault	NetBackup	PodHeitor 1.0.0
RMAN SBT v2 (zero-staging)	S (libobk.so proprietário)	N	N	S (nbora)	S (libobk-rs.so clean-room, Proprietary)
RMAN sem SBT (staging)	S	N	P	P	S + opção FIFO zero-staging
Data Pump (`expdp`)	P (via dump_pump_opt)	N	N	N	S (padrão no 12c+)
exp legado (11g)	S	N	N	N	S
Archivelog contínuo (CDP)	N	N	N	N	S (modo daemon, mode=cdp)
Replicação de DR (compat. SE2)	N	N	N	N	S (archivelog_apply)
Active DG duplicate	N (licença separada)	N	N	EE	S (duplicate_active, sem licença extra)

5.2 Backup Incremental e Avançado

Recurso	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Incremental Nível 0/1 RMAN	S	S	S	S	S
Incremental FROM SCN	S	N	N	P	S + detector de gap de SCN + retomada
Block Change Tracking	S (manual)	S	S	S	S (habilitação automática + verificação de sanidade)
Backup de archivelog	S	S	S	S	S
Autobackup de controlfile	S	S	S	S	S
Backup de SPFILE / pfile / orapw	S	N	N	P	S
Multicanal paralelo	S (ALLOCATE manual)	S	S	S	S (ajuste automático por cores de CPU/IOPS)
Checkpoint / retomada	N	N	N	N	S (ADR-014, cadeia SCN)
Política de exclusão de archivelog	N	N	N	N	S (archivelog_keep_backed_up=N)
Snapshot AWR ao final do Full	N	N	N	N	S (awr_snapshot=yes)

5.3 Topologia e Multitenant

Recurso	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Oracle 11g R2	S	N	P	S	S
Oracle 12c / 18c / 19c / 21c	S	S	S	S	S
Oracle 23ai	P	P	N	P	S (validado em produção)
RAC auto-discovery	M	N	S	S	S (automático + paralelo por nó)
Multitenant CDB/PDB	S (implícito)	S	S	S	S (paralelo por PDB + seletivo)
Controle de papel Data Guard	S (implícito)	N	P	S	S (prefer_standby=no/yes/auto)
Tratamento de caminho ASM	S	S	S	S	S (resolução asmcmd + filtro dbv)
Restauração cross-endian (Solaris→Linux)	M (manual)	N	N	P	S (RMAN CONVERT DATAFILE automático)
Backup de wallet TDE	S	P	P	P	S (ciente de rotação de master-key)

5.4 Automação de Restauração

Recurso	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Restauração sem SSH ao host Oracle	N	N	N	N	S (somente bconsole)
Trilha de auditoria no catálogo Bacula	N	N	N	N	S (JobLog completo + manifesto)
PITR (recuperação pontual)	M (script perl)	M	M	M	S (1 passo, action=pitr)
Restauração baseada em SCN	M	N	N	M	S (1 passo, action=scn)
Recuperação em nível de tabela (12c+)	M	N	N	M	S (1 passo, action=table)
Clone para host/SID diferente	M (beta)	M	M	M	S (action=clone)
RESTORE PREVIEW antes da execução	N	N	N	N	S (preview_first=yes)
VALIDATE DATABASE após restauração	N	N	N	N	S (verify_after=yes)
Modo dry-run	N	N	N	N	S (dry_run=yes)
Flashback Database	N	N	N	N	S (action=flashback)
Formulário web Bacularis para restauração	N	N/A	N/A	N/A	S (integração nativa Bacularis)

5.5 Compressão e Throttle

Recurso	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
RMAN BASIC/MEDIUM/HIGH	S	S	S	S	S
pipe zstd / lz4 pré-SBT	N	N	N	N	S (opção de dupla compressão)
Throttle RMAN RATE	S	S	S	S	S
Throttle I/O cgroups v2	N	N	N	N	S (cgroup_write_bps=)

5.6 Observabilidade e Cadeia de Suprimentos

Recurso	Bacula Enterprise	Veeam	Commvault	NetBackup	PodHeitor
Endpoint Prometheus /metrics	N	N	N	N	S (metrics_addr=host:port)
Canário anti-ransomware	N	S (separado)	S (separado)	S (separado)	S (integrado, amostrador de hash de bloco)
Redação de credenciais no log de auditoria	N	N	N	N	S (senhas/chaves nunca nos logs)
DBVERIFY pós-restauração	N	N	N	N	S (automatizado)
Preflight em modo dry-run	N	N	N	N	S (flag –dry-run)
Builds reproduzíveis	N (proprietário)	N	N	N	S (musl static-pie, Cargo.lock)
SBOM (CycloneDX)	N	N	N	N	S (make sbom)
Auditoria de CVE (cargo-audit + cargo-deny)	N	N	N	N	S (0 CVEs conhecidos)

6. Referência de Opções de Backup

Todos os parâmetros são especificados na diretiva Plugin = do Bacula dentro de um bloco FileSet. Os parâmetros também podem ser colocados no arquivo de configuração (padrão: /opt/bacula/etc/podheitor-oracle.conf) como linhas chave=valor — parâmetros passados na linha do plugin sempre sobrepõem os valores do arquivo de configuração.

6.1 Conexão e Identidade

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`sid`	string	`*` (todos detectados)	Oracle SID (nome da instância). Use `*` para detectar automaticamente todas as instâncias em execução.	1.0.0
`oracle_home`	caminho	`auto`	Caminho do `$ORACLE_HOME`. `auto` lê de `/etc/oratab` ou `oraenv`.	1.0.0
`oracle_user`	string	`/ as sysdba`	Usuário do SO para conexão. Defina como `oracle` para autenticação pelo SO.	1.0.0
`unix_user`	string	`oracle`	Conta do SO para a qual o backend muda antes de iniciar o RMAN/sqlplus.	1.0.0
`use_sudo`	bool	`no`	Prefixar comandos oracle com `sudo -u <unix_user>` em vez de setuid.	1.0.0
`auth`	`os`	`pwfile:<path>`	`walletconn:<alias>`	`os`	Método de autenticação. `os` = `/ as sysdba`. `pwfile:` = arquivo de senha. `walletconn:` = alias TNS do Oracle Wallet.	1.0.0
`config_file`	caminho	`/opt/bacula/etc/podheitor-oracle.conf`	Caminho alternativo para o arquivo de configuração.	1.0.0
`instance`	string	`*`	Filtro de instância RAC. `*` = todas as instâncias.	1.0.0
`verbose`	0–3	`0`	Nível de verbosidade no log de job do Bacula.	1.0.0
`debug`	0–9	`0`	Nível de depuração; ≥5 habilita dumps de frames PTCOMM.	1.0.0
`trace`	caminho	“	Grava log de rastreamento em arquivo (além do log de job do Bacula).	1.0.0

6.2 Modo de Backup

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`mode`	`rman_sbt`	`rman`	`dump`	`cdp`	`replicate`	`dump`	Modo de backup. `rman_sbt` é recomendado para produção.	1.0.0

6.3 Opções RMAN (aplicáveis a mode=rman e mode=rman_sbt)

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`channels`	`auto`	1–64	`auto`	Número de canais de backup RMAN. `auto` ajusta ao número de cores da CPU.	1.0.0
`auto_tune_channels`	bool	`yes`	Quando `channels=auto`, ajusta dinamicamente a contagem de canais com base nos cores disponíveis.	1.0.0
`bct`	`auto`	`on`	`off`	`auto`	Block Change Tracking. `auto` habilita se ainda não estiver habilitado.	1.0.0
`archivelog`	`include`	`exclude`	`only`	`include`	Tratamento de archivelog. `include` = fazer backup após os datafiles. `only` = backup somente de archivelog.	1.0.0
`archivelog_keep_backed_up`	0–99	`0`	Excluir archivelogs da FRA após N cópias de backup. 0 = desabilitado.	1.0.0
`max_rate_mb`	0–99999	`0` (ilimitado)	Limite de taxa por canal RMAN em MB/s. 0 = sem limite (use `cgroup_write_bps` para throttle via cgroups).	1.0.0
`ctrlfile`	caminho	`/tmp/oracle`	Prefixo de caminho de staging para autobackup do controlfile.	1.0.0
`hooks_dir`	caminho	`/opt/bacula/etc`	Diretório verificado em busca de scripts de hook `oracle_before_.rman` / `oracle_after_.rman`.	1.0.0

6.4 Compressão

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`compress`	`none`	`zstd`	`lz4`	`gzip`	`rman_basic`	`rman_medium`	`rman_high`	`zstd`	Algoritmo de compressão. `rman_*` usa a compressão nativa RMAN dentro do bloco RMAN. `zstd`/`lz4`/`gzip` aplica compressão em nível de pipe antes de enviar ao Bacula.	1.0.0
`compress_level`	1–22 (zstd), 1–9 (gzip)	`3`	Nível de compressão (aplica-se apenas a zstd e gzip).	1.0.0

6.5 Canais e Paralelismo

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`parallel_dbs`	1–64	`4`	Máximo de bancos de dados para backup em paralelo (quando `sid=*`).	1.0.0
`parallel_pdbs`	1–64	`4`	Máximo de PDBs para backup em paralelo dentro de um CDB.	1.0.0
`parallel_nodes`	0–64	`0` (todos)	Máximo de nós RAC a usar simultaneamente. 0 = todos os descobertos.	1.0.0
`prefer_standby`	`no`	`yes`	`auto`	`no`	Controle de papel Data Guard. `no` = backup somente no PRIMARY. `yes` = exigir standby físico. `auto` = executar em qualquer papel físico-capaz.	1.0.0

6.6 Multitenant (CDB/PDB)

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`pdbs`	`*`	nomes separados por vírgula	`*`	Filtro de nome de PDB. `*` = todos os PDBs. Exemplo: `pdbs=PDB1,PDB2`.	1.0.0
`pdb_skip_seed`	bool	`yes`	Ignorar `PDB$SEED` (o PDB seed somente leitura) nos backups multitenant.	1.0.0
`exclude_tablespace`	nomes separados por vírgula	“	Nomes de tablespace a excluir do backup.	1.0.0
`exclude_pdb`	nomes separados por vírgula	“	Nomes de PDB a excluir do backup.	1.0.0

6.7 Wallet TDE

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`wallet_backup`	bool	`yes`	Incluir backup do wallet TDE no job.	1.0.0
`wallet_path`	caminho	`auto`	`auto`	Caminho para o diretório do Oracle Wallet. `auto` lê do `sqlnet.ora`.	1.0.0
`wallet_passphrase_file`	caminho	“	Arquivo contendo a frase-senha de abertura do wallet. As permissões devem ser 600.	1.0.0

6.8 Data Pump (mode=dump)

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`dump_format`	`expdp`	`exp`	`expdp`	Usar Data Pump (`expdp`) ou exportação legada (`exp`). Forçado para `exp` no 11g.	1.0.0
`dump_opt`	string	`CONSISTENT=Y GRANTS=y`	Opções extras anexadas à linha de comando `exp`.	1.0.0
`dump_pump_opt`	string	“	Opções extras anexadas ao parfile do `expdp` (ex.: `EXCLUDE=STATISTICS`).	1.0.0
`schema`	`*`	separados por vírgula	`*`	Filtro de schema (owner) para exportação Data Pump. `*` = todos os schemas.	1.0.0

6.9 Proteção Contínua de Dados (mode=cdp)

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`cdp_poll_interval`	1–3600 (segundos)	`5`	Frequência (em segundos) com que o daemon CDP consulta `v$archived_log` em busca de novos logs.	1.0.0
`cdp_max_lag`	1–86400 (segundos)	`300`	Limiar de alarme de RPO em segundos. Dispara `PODHEITOR-ORACLE-AUDIT kind=cdp_lag_exceeded` quando excedido.	1.0.0

6.10 Replicação (mode=replicate)

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`replicate_method`	`duplicate_active`	`archivelog_apply`	`duplicate_active`	`duplicate_active` = RMAN DUPLICATE FROM ACTIVE DATABASE (EE). `archivelog_apply` = bootstrap + aplicação contínua de logs (compatível com SE2).	1.0.0
`target_sid`	string	“	SID do banco de dados standby (obrigatório no modo replicate).	1.0.0
`target_host`	string	“	FQDN ou IP do host standby.	1.0.0
`target_oracle_home`	caminho	“	`$ORACLE_HOME` no host standby.	1.0.0

6.11 Validação (verificação de integridade pós-backup)

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`validate_after`	bool	`yes`	Executar `RMAN VALIDATE BACKUPSET` após cada job de backup.	1.0.0

6.12 Canário Anti-Ransomware

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`canary`	bool	`no`	Habilitar canário de amostragem de hash de bloco. Detecta alterações em massa nos datafiles entre execuções de backup.	1.0.0
`canary_blocks`	1–4096	`64`	Número de blocos aleatórios amostrados por datafile em cada verificação de canário.	1.0.0
`canary_threshold_pct`	1–100	`25`	Percentual de blocos alterados que dispara uma mensagem `PODHEITOR-ORACLE-CANARY-ALERT`.	1.0.0

6.13 Observabilidade

Parâmetro	Tipo / Valores Válidos	Padrão	Descrição	Desde
`metrics_addr`	`host:port`	`0`	`0` (desabilitado)	Endereço de bind para o endpoint HTTP Prometheus `/metrics`. Exemplo: `0.0.0.0:9119`.	1.0.0
`cgroup_write_bps`	0–(uint64)	`0` (desabilitado)	Throttle de escrita I/O cgroups v2 em bytes/s. Requer que o processo backend esteja em uma hierarquia cgroup v2.	1.0.0
`awr_snapshot`	bool	`no`	Criar um snapshot AWR ao final de cada backup Full e gravar relatório de desempenho HTML no diretório de estado. Não é fatal no XE/SE2.	1.0.0
`goldengate_aware`	bool	`no`	Detectar processos GoldenGate ativos e emitir o checkpoint SCN deles antes de cada backup.	1.0.0

6.14 Hooks

Os arquivos de hook são colocados em hooks_dir (padrão /opt/bacula/etc). O backend verifica arquivos que correspondam a esses padrões antes e após a execução do RMAN:

Arquivo de Hook	Gatilho	Observações
`oracle_before_full_backup.rman`	Antes do backup Full RMAN	Nomenclatura compatível com o Enterprise
`oracle_after_full_backup.rman`	Após o backup Full RMAN	Extensão: after-hooks são exclusivos do PodHeitor
`oracle_before_incremental_backup.rman`	Antes do backup Incremental
`oracle_after_incremental_backup.rman`	Após o backup Incremental
`oracle_before_full_backup_<SID>.rman`	Antes do Full — específico por SID	Tem prioridade sobre o hook genérico
`oracle_after_full_backup_<SID>.rman`	Após o Full — específico por SID

As opções de restauração são fornecidas via o RestoreObject pluginrestoreconf, que é incorporado em cada backup e renderizado como prompts interativos no bconsole ou como um formulário no Bacularis. As chaves seguem a sintaxe INI chave = valor com comentários #.

7.1 Campos Principais (todas as ações)

Chave	Tipo / Valores Válidos	Padrão	Descrição
`action`	`pitr`	`scn`	`table`	`clone`	`full`	`preview`	`validate`	`flashback`	`preview`	Ação de restauração a executar. Obrigatório.
`auto_open_resetlogs`	bool	`yes`	Emite automaticamente `ALTER DATABASE OPEN RESETLOGS` após RECOVER DATABASE.
`shutdown_if_open`	bool	`yes`	Emite `SHUTDOWN IMMEDIATE` antes da restauração se o banco de dados estiver aberto.
`parallelism`	`auto`	1–64	`auto`	Número de canais de restauração RMAN. `auto` corresponde à contagem de canais do backup original.
`verify_after`	bool	`yes`	Executa `RMAN VALIDATE DATABASE CHECK LOGICAL` + DBVERIFY após a restauração.
`preview_first`	bool	`no`	Executa `RESTORE DATABASE PREVIEW` antes de iniciar a restauração. Gera um plano sem modificar o banco de dados.
`require_explicit_confirmation`	bool	`yes`	Para ações destrutivas, solicita que o operador digite `yes` no bconsole antes de prosseguir.
`dry_run`	bool	`no`	Analisa e valida a configuração, gera o script RMAN, imprime-o no log do job, mas não o executa.