From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 7250C636D7 for ; Tue, 25 Aug 2020 09:32:58 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 6149F23F00 for ; Tue, 25 Aug 2020 09:32:58 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [212.186.127.180]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id E6AE523EF5 for ; Tue, 25 Aug 2020 09:32:56 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id AC60E4484F for ; Tue, 25 Aug 2020 09:32:56 +0200 (CEST) Date: Tue, 25 Aug 2020 09:32:22 +0200 (CEST) From: Dietmar Maurer To: Proxmox Backup Server development discussion , Dylan Whyte Message-ID: <2088806158.9.1598340742926@webmail.proxmox.com> In-Reply-To: <20200824081742.13214-1-d.whyte@proxmox.com> References: <20200824081742.13214-1-d.whyte@proxmox.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Priority: 3 Importance: Normal X-Mailer: Open-Xchange Mailer v7.10.3-Rev21 X-Originating-Client: open-xchange-appsuite X-SPAM-LEVEL: Spam detection results: 0 AWL 0.122 Adjusted score from AWL reputation of From: address KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment RCVD_IN_DNSWL_MED -2.3 Sender listed at https://www.dnswl.org/, medium trust SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record URIBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [proxmox.com] Subject: Re: [pbs-devel] [PATCH pbs-docs 1/2] Add section "Disk Management" X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 25 Aug 2020 07:32:58 -0000 applied, but removed debug output. See comments below: > On 08/24/2020 10:17 AM Dylan Whyte wrote: >=20 > =20 > Add the section "Disk Management" to the admin guide, explaining > the use of the "disk" subcommand of "proxmox-backup-manager" >=20 > Signed-off-by: Dylan Whyte > --- > docs/administration-guide.rst | 78 +++++++++++++++++++++++++++++++++++ > 1 file changed, 78 insertions(+) >=20 > diff --git a/docs/administration-guide.rst b/docs/administration-guide.rs= t > index acf07930..84e1eb72 100644 > --- a/docs/administration-guide.rst > +++ b/docs/administration-guide.rst > @@ -146,6 +146,84 @@ when setting up the backup server. > filesystem configuration from being supported for a datastore. For ex= ample, > ``ext3`` as a whole or ``ext4`` with the ``dir_nlink`` feature manual= ly disabled. > =20 > +Disk Management > +~~~~~~~~~~~~~~~ > +Proxmox Backup Server comes with a set of disk utilities, which are > +accessed using the ``disk`` subcommand. This subcommand allows you to in= itialize > +disks, create various filesystems, and get information about the disks. > + > +To view the disks connected to the system, use the ``list`` subcommand o= f > +``disk``: > + > +.. code-block:: console > + > + # proxmox-backup-manager disk list > + =E2=94=8C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =AC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=AC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=AC=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=AC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=AC=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=AC=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=AC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=90 > + =E2=94=82 name =E2=94=82 used =E2=94=82 gpt =E2=94=82 disk-type =E2= =94=82 size =E2=94=82 model =E2=94=82 wearout =E2=94=82 stat= us =E2=94=82 > + =E2=95=9E=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95= =AA=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90= =E2=95=AA=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=AA=E2=95=90=E2= =95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95= =90=E2=95=90=E2=95=AA=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90= =E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=AA=E2= =95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95= =90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=AA=E2=95=90= =E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2= =95=AA=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95=90=E2=95= =90=E2=95=A1 > + =E2=94=82 sda =E2=94=82 lvm =E2=94=82 1 =E2=94=82 hdd =E2= =94=82 34359738368 =E2=94=82 QEMU_HARDDISK =E2=94=82 - =E2=94=82 pass= ed =E2=94=82 > + =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=BC=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=BC=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=BC=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=A4 > + =E2=94=82 sdb =E2=94=82 unused =E2=94=82 1 =E2=94=82 hdd =E2= =94=82 68719476736 =E2=94=82 QEMU_HARDDISK =E2=94=82 - =E2=94=82 pass= ed =E2=94=82 > + =E2=94=9C=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=BC=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=BC=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=BC=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=BC=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=A4 > + =E2=94=82 sdc =E2=94=82 unused =E2=94=82 1 =E2=94=82 hdd =E2= =94=82 68719476736 =E2=94=82 QEMU_HARDDISK =E2=94=82 - =E2=94=82 pass= ed =E2=94=82 > + =E2=94=94=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =B4=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=B4=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=B4=E2=94=80=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=B4=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=B4=E2= =94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=B4=E2=94=80= =E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2= =94=B4=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94=80=E2=94= =80=E2=94=98 > + > +To initialize a disk with a new GPT, use the ``initialize`` subcommand: > + > +.. code-block:: console > + > + # proxmox-backup-manager disk initialize sdX > + > +You can create an ``ext4`` or ``xfs`` filesystem on a disk, using ``fs > +create``. The following command creates an ``ext4`` filesystem and passe= s the > +``--add-datastore`` parameter, in order to automatically create a datast= ore on > +the disk (in this case ``sdd``). This will create a datastore at the loc= ation > +``/mnt/datastore/store1``: > + > +.. code-block:: console > + > + # proxmox-backup-manager disk fs create store1 --disk sdd --filesystem= ext4 --add-datastore true > + register worker thread > + register worker > + FILE: "/var/log/proxmox-backup/tasks/EA/UPID:pbs:000016F6:001851EA:000= 00000:5F3D0A26:dircreate:store1:root@pam:" Above is debug output ... > + create datastore 'store1' on disk sdd > + Percentage done: 1 > + ... > + Percentage done: 99 > + TASK OK > + Detected stopped UPID UPID:pbs:000016F6:001851EA:00000000:5F3D0A26:dir= create:store1:root@pam: > + unregister worker Above is debug output ... > +You can also create a ``zpool`` with various raid levels. The command be= low > +creates a mirrored ``zpool`` using two disks (``sdb`` & ``sdc``) and mou= nts it > +on the root directory (default): > + > +.. code-block:: console > + > + # proxmox-backup-manager disk zpool create zpool1 --devices sdb,sdc --= raidlevel mirror > + register worker thread > + register worker > + FILE: "/var/log/proxmox-backup/tasks/F5/UPID:pbs:00001544:001814F5:000= 00000:5F3D098A:zfscreate:zpool1:root@pam:" Above is debug output ... > + create Mirror zpool 'zpool1' on devices 'sdb,sdc' > + # "zpool" "create" "-o" "ashift=3D12" "zpool1" "mirror" "sdb" "sdc" > + > + TASK OK > + Detected stopped UPID UPID:pbs:00001544:001814F5:00000000:5F3D098A:zfs= create:zpool1:root@pam: > + unregister worker Above is debug output ... > +.. note:: > + You can also pass the ``--add-datastore`` parameter here, to automatic= ally > + create a datastore from the disk. > + > +You can use ``disk fs list`` and ``disk zpool list`` to keep track of yo= ur > +filesystems and zpools respectively. > + > +If a disk supports S.M.A.R.T. capability, and you have this enabled, you= can > +display S.M.A.R.T. attributes using the command: > + > +.. code-block:: console > + > + # proxmox-backup-manager disk smart-attributes sdX > =20 > Datastore Configuration > ~~~~~~~~~~~~~~~~~~~~~~~ > --=20 > 2.20.1 >=20 >=20 >=20 > _______________________________________________ > pbs-devel mailing list > pbs-devel@lists.proxmox.com > https://lists.proxmox.com/cgi-bin/mailman/listinfo/pbs-devel