Mover grupos de copias entre namespaces en Proxmox Backup Server

Los namespaces permiten organizar las copias almacenadas en un datastore de Proxmox Backup Server. Desde PBS 4.2 se pueden mover grupos de copias entre namespaces del mismo datastore con proxmox-backup-client group move, que Proxmox incorporó para reorganizar copias manteniendo la consistencia [1][2].

Esta guía mueve un grupo de copias —por ejemplo, el grupo de un contenedor—, no un único snapshot aislado. El procedimiento usa el cliente oficial y evita manipular directamente los directorios internos del datastore.

Requisitos y variables

• PBS 4.2 o posterior, con proxmox-backup-client disponible.
• Una identidad con permisos adecuados para leer el origen y modificar el datastore y namespace de destino [2].
• El nombre del datastore, el namespace de origen, el destino y el identificador del grupo que se moverá.

Define el repositorio con el formato [[auth-id@]servidor[:puerto]:]datastore. En el ejemplo se usan nombres ficticios:

export PBS_REPOSITORY='admin@pbs@pbs.example.invalid:backup'
SOURCE_NS='origen'
TARGET_NS='destino'
BACKUP_GROUP='ct/101'

El repositorio de ejemplo no contiene credenciales. Si la instalación solicita autenticación, introduce los datos mediante el mecanismo configurado para tu cuenta; no los añadas a un post, historial de shell o repositorio.

Revisar el origen y preparar el destino

Lista los namespaces y los grupos disponibles antes de mover datos:

proxmox-backup-client namespace list --repository "$PBS_REPOSITORY"
proxmox-backup-client list --ns "$SOURCE_NS" --repository "$PBS_REPOSITORY"

Si el namespace de destino todavía no existe, créalo con el cliente de PBS:

proxmox-backup-client namespace create "$TARGET_NS" \
  --repository "$PBS_REPOSITORY"

Comprueba que el grupo que vas a mover es el esperado y que no hay en el destino otro grupo con el mismo tipo e identificador. El movimiento de grupo puede combinar snapshots cuando el grupo de destino coincide y se cumplen los requisitos de propietario y cronología; el ejemplo desactiva esa combinación para que el comando no fusione grupos [2][3].

Mover un grupo de copias

Para trasladar el grupo ct/101 desde origen hasta destino:

proxmox-backup-client group move "$BACKUP_GROUP" \
  --ns "$SOURCE_NS" \
  --target-ns "$TARGET_NS" \
  --merge-group false \
  --repository "$PBS_REPOSITORY"

El tipo del grupo identifica la carga respaldada: por ejemplo, ct/101 para el contenedor 101 o vm/101 para la máquina virtual con ese identificador. Cambia los valores de ejemplo por los que hayas comprobado en el listado. El traslado actúa sobre el grupo y sus snapshots, no solo sobre el último punto de restauración [2][3].

Verificar el resultado

Vuelve a listar el namespace de destino y confirma que el grupo y sus snapshots aparecen allí:

proxmox-backup-client list --ns "$TARGET_NS" \
  --repository "$PBS_REPOSITORY"

Revisa también el resultado y el registro de la tarea en PBS. Si el comando informa de grupos omitidos, bloqueos o permisos insuficientes, resuelve la causa y vuelve a comprobar origen y destino antes de repetir la operación.

No muevas a mano archivos de .chunks ni alteres sus fechas de acceso para controlar la recolección de basura. Usa los comandos documentados de PBS para administrar copias y datastores.

En resumen

• Comprueba que el servidor y el cliente usan PBS 4.2 o posterior.
• Identifica el grupo y ambos namespaces antes de iniciar el cambio.
• Usa proxmox-backup-client group move para mover el grupo dentro del mismo datastore.
• Verifica el destino y el registro de la tarea al terminar.

📚 Fuentes consultadas

1. Hoja de ruta y notas de versión — Proxmox Backup Server 4.2
2. Backup Storage: moving namespaces and groups — Proxmox Backup Documentation
3. proxmox-backup-client: group move — Proxmox Backup Documentation

Imagen