Bug 209157 - Section 14.5.1 Updating Multiple Jails has several errors/ommissions
Summary: Section 14.5.1 Updating Multiple Jails has several errors/ommissions
Status: Closed Overcome By Events
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:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-04-30 00:32 UTC by baho utot
Modified: 2023-09-20 09:01 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description baho utot 2016-04-30 00:32:40 UTC
In the handbook Section14.5 Updating Multiple Jails has the following error/ommissions:

Section 14.5.1 under 3. Create a skeleton for the read-write portion of the system:

need to add the following: mv dev /home/j/skel

Section 14.5.1 under 4. Use mergemaster to install missing configuration files....

this:       rm -R bin boot lib libexec mnt proc rescue sbin sys usr dev
should be:  rm -R bin boot lib libexec mnt proc rescue sbin sys usr

Section 14.5.1 under 5. Now, symlink the read-write file system to the read-only file system....

# mkdir s                   should be # mkdir s s/portbuild
ln -s s/usr-local usr/local should be # ln -s ../s/usr-local usr/local
ln -s s/usr-X11R6 usr/X11R6 should be # ln -s ../s/usr-X11R6 usr/X11R6
ln -s s/distfiles usr/ports/distfiles should be 
ln -s ../../s/distfiles usr/ports/distfiles
and add ln -s s/dev/dev
Comment 1 commit-hook freebsd_committer freebsd_triage 2023-09-20 08:34:08 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=612b7cc1721224c494c5b2600188e1508bb5611b

commit 612b7cc1721224c494c5b2600188e1508bb5611b
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-09-20 08:15:40 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-09-20 08:15:40 +0000

    Handbook - Jails: Rewrite the chapter

    Changes:
    - Add jail types info: Thick, Thin, VNET and Linux Jails
    - Add info about the necessary configuration on the host system
    - Add info about types of networking in the jails
    - Explain the jail config file
    - Add info about how to configure Thick, Thin, VNET and Linux Jails
    - Explain how to upgrade the different types of jails
    - Add info about the resources limits in a Jail
    - Add info about different jail managers and containers

    Information obtained from:
    - https://man.freebsd.org/cgi/man.cgi?query=jail&sektion=8
    - https://wiki.freebsd.org/Jails
    - https://man.freebsd.org/cgi/man.cgi?rctl(8)
    - https://vermaden.wordpress.com/2023/06/28/freebsd-jails-containers/
    - https://clinta.github.io/freebsd-jails-the-hard-way/
    - https://jacob.ludriks.com/2017/06/07/FreeBSD-Thin-Jails/
    - Jails and VNET a guide - Derik J. Ramirez
    - https://wb-hk.blogspot.com/2016/04/freebsd-jails-4-thin-jails-using-nullfs.html
    - https://blog.uidrafter.com/freebsd-jails-network-setup
    - https://forums.freebsd.org/threads/setting-up-a-debian-linux-jail-on-freebsd.68434/
    - https://github.com/msimerson/Mail-Toaster-6/wiki/Linux-Jails
    - https://etherealwake.com/2021/08/freebsd-jail-networking/
    - https://wiki.freebsd.org/TomMarcoen/JailNetworking
    - https://weblog.antranigv.am/posts/2020/06/vnet-jail-howto/

    PR:                     203641, 200905, 209157, 248150, 263330, 264317,
                            226282, 239861, 166358, 178221, 265410
    Reviewed by:            karels@, fernape@, jrm@
    Differential Revision:  https://reviews.freebsd.org/D41450

 .../content/en/books/handbook/jails/_index.adoc    | 1492 ++++++++++----------
 1 file changed, 715 insertions(+), 777 deletions(-)
Comment 2 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-09-20 09:01:43 UTC
I'm gonna mark this as overcome by events since the chapter has been rewritten
in: https://cgit.freebsd.org/doc/commit/?id=612b7cc1