---
name: pbs-config
description: Configuracao do Proxmox Backup Server (PBS) -- criacao de datastores, politicas de retencao, sync jobs e remote targets para estrategia 3-2-1.
---

# PBS Config

Configuracao completa de Proxmox Backup Server (PBS) com datastores, politicas de retencao, sync jobs e estrategia de backup 3-2-1.

## Quando Usar

- Configurar PBS apos instalacao Proxmox
- Criar datastores para backups
- Definir retention policies (7 daily, 4 weekly, 6 monthly)
- Configurar remote sync entre nodes PBS
- Implementar estrategia 3-2-1 backup

## Sintaxe

```bash
/pbs-config <datastore-path> [--retention 7:4:6] [--remote-sync node2] [--dedup on]
```

## Exemplos

```bash
# PBS basico com retention padrao
/pbs-config /mnt/pbs-datastore

# PBS com retention custom e remote sync
/pbs-config /mnt/pbs-datastore --retention 10:5:12 --remote-sync pbs-node2.descomplicar.pt

# PBS sem deduplicacao (se storage nao suporta)
/pbs-config /mnt/pbs-main --dedup off
```

## Knowledge Sources (Consultar SEMPRE)

### NotebookLM Proxmox Research
```bash
mcp__notebooklm__notebook_query \
  notebook_id:"276ccdde-6b95-42a3-ad96-4e64d64c8d52" \
  query:"proxmox backup server pbs datastore retention deduplication"
```

### Hub Docs
- Hub/05-Projectos/Cluster Descomplicar/Research/Proxmox-VE/Guia-Definitivo-Proxmox-Hetzner.md
- Modulo 3: Storage e Backups (PBS, estrategia 3-2-1, deduplicacao)

## Workflow Resumo

O setup completo segue 8 fases. Detalhes em `references/pbs-setup-completo.md`.

### Fases

| Fase | Descricao | Comandos-chave |
|------|-----------|----------------|
| 1 | Instalacao PBS | `apt install proxmox-backup-server` |
| 2 | Criar Datastore | `proxmox-backup-manager datastore create` |
| 3 | Users e Permissions | `proxmox-backup-manager user create` |
| 4 | Integrar PVE com PBS | `pvesm add pbs` |
| 5 | Backup Jobs | `vzdump --storage pbs-main` |
| 6 | Remote Sync (cluster) | `proxmox-backup-manager sync-job create` |
| 7 | Monitoring | `proxmox-backup-manager datastore status` |
| 8 | Teste Restore | `qmrestore pbs-main:backup/...` |

### Comandos Essenciais

```bash
# Criar datastore
proxmox-backup-manager datastore create main-store /mnt/pbs-datastore

# Retention padrao (7d/4w/6m/3y)
proxmox-backup-manager datastore update main-store \
  --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --keep-yearly 3

# User dedicado
proxmox-backup-manager user create pve-backup@pbs --email admin@descomplicar.pt

# Adicionar PBS ao PVE
pvesm add pbs pbs-main --server SERVER_IP --datastore main-store --username pve-backup@pbs

# Backup diario
vzdump --storage pbs-main --mode snapshot --compress zstd --all 1

# Remote sync
proxmox-backup-manager sync-job create sync-from-node-b \
  --remote pbs-node-b --remote-store main-store --store secondary-store \
  --schedule "0 3 * * *" --remove-vanished true

# Garbage collection
proxmox-backup-manager garbage-collection start main-store

# Verificacao integridade
proxmox-backup-manager verify-job create verify-main \
  --store main-store --schedule "0 4 * * 0"
```

## Estrategia 3-2-1

| Componente | Implementacao |
|------------|---------------|
| 3 copias | VMs producao + PBS Node B + PBS Node A sync |
| 2 medias | NVMe (producao) + HDD Enterprise (PBS) |
| 1 off-site | Hetzner Storage Box / S3 / PBS externo |
| RPO | 1h (hourly se critico) |
| RTO | 2-4h (restore + validacao) |

## Troubleshooting Rapido

| Problema | Solucao |
|----------|---------|
| "no space" | `garbage-collection start` + reduzir retention |
| Remote sync falha | Verificar conectividade + auth + `journalctl -u proxmox-backup` |
| Dedup ratio baixo | VMs encrypted nao deduplica; verificar chunk size |

Detalhes completos em `references/pbs-avancado.md`.

## Quando NAO Usar

- Para backups ad-hoc manuais (usar vzdump directo)
- Para PBS ja configurado (usar troubleshooting guides)
- Para restore procedures (criar skill especifica se necessario)

## References

- **NotebookLM:** 276ccdde-6b95-42a3-ad96-4e64d64c8d52
- **PBS Docs:** https://pbs.proxmox.com/docs/
- **Guia Hub:** Hub/05-Projectos/Cluster Descomplicar/Research/Proxmox-VE/Guia-Definitivo-Proxmox-Hetzner.md (Modulo 3)
- **Setup detalhado:** `references/pbs-setup-completo.md`
- **Avancado e troubleshooting:** `references/pbs-avancado.md`

## Metadata (Desk CRM Task #1712)

```
Projecto: Cluster Proxmox Descomplicar (#65)
Tarefa: Migracao Infraestrutura (#1712)
Tags: pbs, backup, retention, deduplication, sync
```

---

## Healing Log

Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.

```jsonl
{"date":"","issue":"","fix":"","source":"user|auto"}
```

*Adicionar nova linha após cada erro corrigido.*
