Date: Sun, 15 Apr 2018 14:54:26 +0000 (UTC) From: Allan Jude <allanjude@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r51556 - head/en_US.ISO8859-1/books/handbook/disks Message-ID: <201804151454.w3FEsQwp027743@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: allanjude Date: Sun Apr 15 14:54:26 2018 New Revision: 51556 URL: https://svnweb.freebsd.org/changeset/doc/51556 Log: Improve the instructions for growing disks The previous instructions did not explaina all of the steps, and lacked information to explain to the user which numbers and device names they might need to change for their circumstances Reported by: Myke Geiger Reviewed by: bcr Sponsored by: ScaleEngine Inc. Differential Revision: https://reviews.freebsd.org/D14502 Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Sun Apr 15 14:50:27 2018 (r51555) +++ head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Sun Apr 15 14:54:26 2018 (r51556) @@ -256,10 +256,18 @@ ada0 recovered</screen> Here, the last partition on the disk is the swap partition, but the second partition is the one that needs to be resized. Swap partitions only contain temporary data, so it can safely be - unmounted, deleted, and then recreated after resizing other - partitions.</para> + unmounted, deleted, and then recreate the third partition after + resizing the second partition.</para> - <screen>&prompt.root; <userinput>swapoff <replaceable>/dev/ada0p3</replaceable></userinput> + <para>Disable the swap partition:</para> + + <screen>&prompt.root; <userinput>swapoff <replaceable>/dev/ada0p3</replaceable></userinput></screen> + + <para>Delete the third partition, specified by the + <option>-i</option> flag, from the disk + <replaceable>ada0</replaceable>.</para> + + <screen> &prompt.root; <userinput>gpart delete -i <replaceable>3</replaceable> <replaceable>ada0</replaceable></userinput> ada0p3 deleted &prompt.root; <userinput>gpart show <replaceable>ada0</replaceable></userinput> @@ -281,11 +289,14 @@ ada0p3 deleted </warning> <para>Resize the partition, leaving room to recreate a swap - partition of the desired size. This only modifies the size of - the partition. The file system in the partition will be - expanded in a separate step.</para> + partition of the desired size. The partition to resize is + specified with <option>-i</option>, and the new desired size + with <option>-s</option>. Optionally, alignment of the + partition is controlled with <option>-a</option>. This only + modifies the size of the partition. The file system in the + partition will be expanded in a separate step.</para> - <screen>&prompt.root; <userinput>gpart resize -i <replaceable>2</replaceable> -a 4k -s <replaceable>47G</replaceable> <replaceable>ada0</replaceable></userinput> + <screen>&prompt.root; <userinput>gpart resize -i <replaceable>2</replaceable> -s <replaceable>47G</replaceable> -a 4k <replaceable>ada0</replaceable></userinput> ada0p2 resized &prompt.root; <userinput>gpart show <replaceable>ada0</replaceable></userinput> => 34 102399933 ada0 GPT (48G) @@ -293,7 +304,9 @@ ada0p2 resized 162 98566144 2 freebsd-ufs (47G) 98566306 3833661 - free - (1.8G)</screen> - <para>Recreate the swap partition:</para> + <para>Recreate the swap partition and activate it. If no size + is specified with <option>-s</option>, all remaining space is + used:</para> <screen>&prompt.root; <userinput>gpart add -t freebsd-swap -a 4k <replaceable>ada0</replaceable></userinput> ada0p3 added @@ -307,12 +320,6 @@ ada0p3 added <para>Grow the <acronym>UFS</acronym> file system to use the new capacity of the resized partition:</para> - <note> - <para>Growing a live <acronym>UFS</acronym> file system is only - possible in &os; 10.0-RELEASE and later. For earlier - versions, the file system must not be mounted.</para> - </note> - <screen>&prompt.root; <userinput>growfs <replaceable>/dev/ada0p2</replaceable></userinput> Device is mounted read-write; resizing will result in temporary write suspension for /. It's strongly recommended to make a backup before growing the file system. @@ -320,6 +327,12 @@ OK to grow file system on /dev/ada0p2, mounted on /, f super-block backups (for fsck -b #) at: 80781312, 82063552, 83345792, 84628032, 85910272, 87192512, 88474752, 89756992, 91039232, 92321472, 93603712, 94885952, 96168192, 97450432</screen> + + <para>If the file system is <acronym>ZFS</acronym>, the resize is + triggered by running the <option>online</option> subcommand with + <option>-e</option>:</para> + + <screen>&prompt.root; <userinput>zpool online -e <replaceable>zroot</replaceable> <replaceable>/dev/ada0p2</replaceable></userinput></screen> <para>Both the partition and the file system on it have now been resized to use the newly-available disk space.</para>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201804151454.w3FEsQwp027743>