From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) by lore.proxmox.com (Postfix) with ESMTPS id B90201FF13C for ; Thu, 16 Apr 2026 19:18:47 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 98EB8D8BF; Thu, 16 Apr 2026 19:18:45 +0200 (CEST) From: Hannes Laimer To: pbs-devel@lists.proxmox.com Subject: [PATCH proxmox-backup v7 4/9] docs: add section on moving namespaces and groups Date: Thu, 16 Apr 2026 19:18:25 +0200 Message-ID: <20260416171830.266553-5-h.laimer@proxmox.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260416171830.266553-1-h.laimer@proxmox.com> References: <20260416171830.266553-1-h.laimer@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1776359843624 X-SPAM-LEVEL: Spam detection results: 0 AWL 0.083 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Message-ID-Hash: J6DH5HBQFLRYNJ2VUMM55YBH3VJC4M3Y X-Message-ID-Hash: J6DH5HBQFLRYNJ2VUMM55YBH3VJC4M3Y X-MailFrom: h.laimer@proxmox.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.10 Precedence: list List-Id: Proxmox Backup Server development discussion List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Document the move-group and move-namespace operations including merge behavior, max-depth and delete-source parameters. Add an online help anchor so the UI move dialogs can link directly to this section. Signed-off-by: Hannes Laimer --- docs/storage.rst | 45 ++++++++++++++++++++++++++++++++++++++++++- www/OnlineHelpInfo.js | 4 ++++ 2 files changed, 48 insertions(+), 1 deletion(-) diff --git a/docs/storage.rst b/docs/storage.rst index 672091f8..ad507fd4 100644 --- a/docs/storage.rst +++ b/docs/storage.rst @@ -527,7 +527,50 @@ For backup groups, the existing privilege rules still apply. You either need a privileged enough permission or to be the owner of the backup group; nothing changed here. -.. todo:: continue +.. _storage_move_namespaces_groups: + +Moving Namespaces and Groups +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Backup groups can be moved between namespaces within the same datastore. +This is useful for reorganizing backup hierarchies without having to +re-run backups. + +A single group can be moved with ``move-group``. To relocate an entire +namespace subtree (including all child namespaces and their groups), use +``move-namespace``. + +.. code-block:: console + + # proxmox-backup-manager datastore move-group --ns --target-ns --backup-type --backup-id + # proxmox-backup-manager datastore move-namespace --ns --target-ns + +If the target namespace already exists, groups are moved into it. When a +group with the same type and ID already exists in the target and +``merge-groups`` is enabled, the snapshots are merged into the existing +group provided: + +- both groups have the same owner +- the oldest source snapshot is newer than the newest target snapshot + +Groups that cannot be merged or locked are skipped and reported in the +task log. They remain at the source and can be retried individually with +``move-group``. + +Optional parameters for ``move-namespace``: + +``merge-groups`` + Allow merging snapshots into groups that already exist in the target + namespace with the same type and ID. Defaults to false. + +``max-depth`` + Limits how many levels of child namespaces below the source are + included. When not set, the entire subtree is moved. + +``delete-source`` + Controls whether the source namespace directories are removed after + all groups have been moved out. Defaults to true. Set to false to + keep the (now empty) source namespace structure. Options diff --git a/www/OnlineHelpInfo.js b/www/OnlineHelpInfo.js index 89650cfb..e118b0ad 100644 --- a/www/OnlineHelpInfo.js +++ b/www/OnlineHelpInfo.js @@ -299,6 +299,10 @@ const proxmoxOnlineHelpInfo = { "link": "/docs/storage.html#storage-namespaces", "title": "Backup Namespaces" }, + "storage-move-namespaces-groups": { + "link": "/docs/storage.html#storage-move-namespaces-groups", + "title": "Moving Namespaces and Groups" + }, "datastore-tuning-options": { "link": "/docs/storage.html#datastore-tuning-options", "title": "Tuning" -- 2.47.3