From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <pbs-devel-bounces@lists.proxmox.com>
Received: from firstgate.proxmox.com (firstgate.proxmox.com [IPv6:2a01:7e0:0:424::9])
	by lore.proxmox.com (Postfix) with ESMTPS id D4B8220EC88
	for <inbox@lore.proxmox.com>; Wed, 24 Apr 2024 13:53:44 +0200 (CEST)
Received: from firstgate.proxmox.com (localhost [127.0.0.1])
	by firstgate.proxmox.com (Proxmox) with ESMTP id A172AA113;
	Wed, 24 Apr 2024 13:53:49 +0200 (CEST)
Mime-Version: 1.0
Date: Wed, 24 Apr 2024 13:53:16 +0200
Message-Id: <D0SBYWQAJBCK.214I6OL1MK92@proxmox.com>
To: "Proxmox Backup Server development discussion"
 <pbs-devel@lists.proxmox.com>
From: "Gabriel Goller" <g.goller@proxmox.com>
X-Mailer: aerc 0.17.0-91-g65332c233880-dirty
References: <20240423083000.28002-1-h.laimer@proxmox.com>
 <20240423083000.28002-15-h.laimer@proxmox.com>
In-Reply-To: <20240423083000.28002-15-h.laimer@proxmox.com>
X-SPAM-LEVEL: Spam detection results:  0
 AWL -0.229 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
 POISEN_SPAM_PILL          0.1 Meta: its spam
 POISEN_SPAM_PILL_1        0.1 random spam to be learned in bayes
 POISEN_SPAM_PILL_3        0.1 random spam to be learned in bayes
 SPF_HELO_NONE           0.001 SPF: HELO does not publish an SPF Record
 SPF_PASS               -0.001 SPF: sender matches SPF record
Subject: Re: [pbs-devel] [PATCH proxmox-backup v9 14/26] docs: add removable
 datastores section
X-BeenThere: pbs-devel@lists.proxmox.com
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Proxmox Backup Server development discussion
 <pbs-devel.lists.proxmox.com>
List-Unsubscribe: <https://lists.proxmox.com/cgi-bin/mailman/options/pbs-devel>, 
 <mailto:pbs-devel-request@lists.proxmox.com?subject=unsubscribe>
List-Archive: <http://lists.proxmox.com/pipermail/pbs-devel/>
List-Post: <mailto:pbs-devel@lists.proxmox.com>
List-Help: <mailto:pbs-devel-request@lists.proxmox.com?subject=help>
List-Subscribe: <https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel>, 
 <mailto:pbs-devel-request@lists.proxmox.com?subject=subscribe>
Reply-To: Proxmox Backup Server development discussion
 <pbs-devel@lists.proxmox.com>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: pbs-devel-bounces@lists.proxmox.com
Sender: "pbs-devel" <pbs-devel-bounces@lists.proxmox.com>

On Tue Apr 23, 2024 at 10:29 AM CEST, Hannes Laimer wrote:
> Signed-off-by: Hannes Laimer <h.laimer@proxmox.com>
> ---
>  docs/storage.rst | 29 +++++++++++++++++++++++++++++
>  1 file changed, 29 insertions(+)
>
> diff --git a/docs/storage.rst b/docs/storage.rst
> index 4444c423..7bfd016c 100644
> --- a/docs/storage.rst
> +++ b/docs/storage.rst
> @@ -165,6 +165,35 @@ following command creates a new datastore called ``store1`` on
>    # proxmox-backup-manager datastore create store1 /backup/disk1/store1
>  
>  
> +Removable Datastores
> +^^^^^^^^^^^^^^^^^^^^
> +Removable datastores have a ``backing-device`` associadted with them, they can be

'associadted' -> 'associated'

> +mounted and unmounted. Other than that they behave the same way a normal Datastore

'Datastores' -> 'datastores'

> +would.
> +
> +They can be created on already correctly formatted partitions, as with normal Datastores

'Datastores' -> 'datastores'

> +the partitions should be either ``ext4`` or ``xfs``. It is also possible to

I think this sentence can be rewritten to be more legible as such: 

    They can be created on already correctly formatted partitions, which, 
    as with normal datastores, should be either ``ext4`` or ``xfs``.

> +create them on completely unused disks through "Administartion" > "Disks / Storage" > "Directory",

'Administartion' -> 'Administration'

> +using this methos the disk will be partitioned and formated actomatically for the datastore.

'methos' -> 'method'
'formated' -> 'formatted'
'actomatically' -> 'automatically'

> +
> +They are mounted automatically when plugged in. It is possible to create a
> +removable Datastore on one PBS and use it on mutiple, the device just has to be added

'Datastore' -> 'datastore'
'mutiple' -> 'multiple'

> +on all as a removable Datastore. This can be done using the normal `Create Datastore`

'Datastore' -> 'datastore'

> +form, by checking **Removable datastore**, selecting the device and setting the correct path.
> +If the devcice already contains a datastore at the speciefied path it'll just be added as

'devcice' -> 'device'
'speciefied' -> 'specified'

> +a new Datastore to the PBS instance and will be mounted whenever plugged in. Unmounting has

'Datastore' -> 'datastore'

> +to be done through the UI by clicking "Unmount" on the summary page or using the CLI
> +
> +.. code-block:: console
> +
> +  # proxmox-backup-manager datastore unmount store1
> +
> +both will wait for any running tasks and unmount the device once the last finishes.

I think this reads better:

    both will wait for any running tasks to finish and unmount the device.

> +
> +All removable datastores will be mounted under ``/mnt/datastore/<name>`` and the
> +specified path is the on-device path.

This part of the sentence is kind of unclear, could you maybe explain it
more simply?

    and the specified path is the on-device path

> +
> +
>  Managing Datastores
>  ^^^^^^^^^^^^^^^^^^^
>  



_______________________________________________
pbs-devel mailing list
pbs-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel