Bug 266743 - Potentially misleading information about -dvd1.iso in release documentation and the FreeBSD Handbook
Summary: Potentially misleading information about -dvd1.iso in release documentation a...
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Sergio Carlavilla Delgado
URL: https://codeberg.org/FreeBSD/freebsd-...
Keywords: needs-patch
Depends on: 238314
Blocks:
  Show dependency treegraph
 
Reported: 2022-10-01 19:00 UTC by Graham Perrin
Modified: 2023-08-26 07:18 UTC (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2022-10-01 19:00:13 UTC
<https://www.freebsd.org/releases/13.1R/announce/#_availability>, for example: 

> This contains everything necessary to install … and a small set of 
> pre-built packages aimed at getting a graphical workstation up and running. 
> … This should be all you need …

As far as I can tell: the set is unusable whilst booted from the installation medium. Please see, for example, bug 238314 comment 2. 

If the intention is for the set to be used after booting the installed system: documentation is lacking. I found a partial answer at <https://unix.stackexchange.com/a/434857/13260>. 


Also, <https://docs.freebsd.org/en/books/handbook/bsdinstall/#bsdinstall-installation-media>: 

> … contains a set of popular binary packages for installing a window manager 
> and some applications so that a complete system can be installed from media 
> without requiring a connection to the Internet. 

I guess, pkg(7) can be used after booting the installed system, to bootstrap from the repository on the DVD but again, documentation is lacking. 

<https://www.freebsd.org/cgi/man.cgi?query=pkg&sektion=7&manpath=FreeBSD>
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-10-02 01:45:27 UTC
After finding a workaround (to bugs affecting bsdconfig(8)) in the FreeBSD Mall at <https://www.freebsdmall.com/cgi-bin/fm/bsddvd13.1?id=y5PfenJ6&mv_pc=39>, I found much the same linked from the previously mentioned answer in Unix & Linux Stack Exchange: 

<https://unix.stackexchange.com/a/215704/13260>

The original erratum: <https://gitlab.com/FreeBSD/freebsd-doc/-/blob/main/website/content/en/releases/10.1R/errata.adoc?plain=1#L115-155>
Comment 2 Fernando Apesteguía freebsd_committer freebsd_triage 2022-10-09 15:55:28 UTC
^Triage: reporter is committer, assign accordingly.
Comment 3 Ian Smith 2022-11-13 05:04:45 UTC
Of all suggested docs, I found the briefest and clearest (for 13.x) to be

https://www.freebsdmall.com/cgi-bin/fm/bsddvd13.1?id=y5PfenJ6&mv_pc=39

Here's an adaptation including use of USB stick or md device - which could be
updated later for use of bsdconfig as new patches are tested and committed.

~~~~~~~

How to install packages from the dvd1 image:

 • Mount the DVD to the '/dist' directory:
   # mkdir -p /dist
   # mount -t cd9660 /dev/cd0 /dist

 • To install known packages, run:
   # env REPOS_DIR=/dist/packages/repos pkg install xorg [...]

 • To view the list of available packages on the DVD, run:
   # env REPOS_DIR=/dist/packages/repos pkg rquery "%n"


If you have the .iso image dd'd to an USB memstick,
replace mount /dev/cd0 above with e.g. /dev/da0

Or to mount an .iso file on disk directly:
   # mdconfig -f /path/to/release.iso
   [reported unit e.g. md0]
   # mount -t cd9660 /dev/md0 /dist
Comment 4 Ian Smith 2022-11-13 05:09:32 UTC
Just a suggestion Graham, use anything useful.

I know I tend to being too wordy.
Comment 5 Graham Perrin freebsd_committer freebsd_triage 2022-11-13 11:11:49 UTC
Thanks.

Re: comment #1, the GitLab view is currently bugged, so I'm adding a Codeberg link. 

The original, rendered: third bullet point under <https://www.freebsd.org/releases/10.1R/errata/#open-issues>.