Bug 227050

Summary:	Handbook Does Not Recommend Using Label for Installation Partition
Product:	Documentation	Reporter:	freebsd.org
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	New ---
Severity:	Affects Only Me
Priority:	---
Version:	Latest
Hardware:	amd64
OS:	Any
Bug Depends on:
Bug Blocks:	263315

Description freebsd.org 2018-03-28 19:39:56 UTC

I am new to FreeBSD and I wanted to install it to an 8GB SD card on my MSI X-610 laptop (from a USB stick).  However, after the installation completed the boot process failed.  This is because the device name for the SD card changed (from /dev/da1s1a) after the install and I had to label the partition (using tunefs) and manually edit the /etc/fstab file to get it working.  All of this could have been avoided if the handbook had stressed the usefulness/importance of using labels (especially if installing to removable media) during the disk selection section of the installation process.  It would also be good if the FreeBSD installer were to prompt to label the installation partition (again during the disk selection section of the installation process), especially if installing to removable media.

Comment 1 Graham Perrin freebsd_committer

2021-12-28 14:13:06 UTC

From <https://cgit.freebsd.org/doc/commit/documentation/content/en/books/handbook?id=f6cee70fe2595252099fa05c9b5dc4ddb6b1bd35> (2021-07-10): 

> handbook/basics/disk-organization: add nvme disk names

> … Note: this section needs a refresh to move 
> from MBR slice and disklabel to GPT slices.

<https://docs.freebsd.org/en/books/handbook/basics/#disk-organization>