Mercurial > hgrepos > FreeBSD > ports > sysutils > local-bsdtools

annotate docs/man/man8/ftjail.rst @ 470:c65a79d84e9e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
FIX: German -> englich in man
author Franz Glasner <fzglas.hg@dom66.de>
date Thu, 22 Aug 2024 03:34:36 +0200
parents 3108ce603fa1
children 260a81d769a6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
1 .. -*- coding: utf-8; indent-tabs-mode: nil; -*-
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
2
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
3 ftjail
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
4 ======
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
5
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
6 Synopsis
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
7 --------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
8
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
9 **ftjail -hV**
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
10
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
11 **ftjail subcommand**
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
12
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
13
298
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
14 Description
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
15 -----------
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
16
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
17 Management tool for Thin Jails: creation of base and skeleton datasets,
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
18 mount and population helpers.
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
19
323
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
20 The following global options are implemented:
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
21
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
22 .. program:: ftjail
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
23
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
24 .. option:: -h
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
25
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
26 Print a short usage message to stdout and exit.
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
27
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
28 .. option:: -V
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
29
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
30 Print the program name and version number to stdout and exit.
e98bc7f40803 Man: Document the global options "-h" and "-V" in all affected manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 308
diff changeset
31
298
41f32fdbecf3 Wording in manual pages
Franz Glasner <fzglas.hg@dom66.de>
parents: 294
diff changeset
32
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
33 Subcommands
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
34 -----------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
35
308
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
36 :manpage:`ftjail-build-etcupdate-current-tmpl(8)`
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
37
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
38 Build a "current" tree suitable for the default and extract mode
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
39 of \"etcupdate\"
2102b46566f0 Implement "ftjail build-etcupdate-curent-tmpl".
Franz Glasner <fzglas.hg@dom66.de>
parents: 307
diff changeset
40
372
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
41 :manpage:`ftjail-copy-skel(8)`
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
42
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
43 Recursively copy template skeleton contents into jail-specific datasets
c10fce8ffe91 FIX: The manpage of ftjail-copy-skel(8) was missing in ftjail(8)
Franz Glasner <fzglas.hg@dom66.de>
parents: 334
diff changeset
44
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
45 :manpage:`ftjail-datasets-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
46
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
47 Create ZFS template datasets for new Thin Jails using base and skeleton
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
48
334
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
49 :manpage:`ftjail-freebsd-update(8)`
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
50
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
51 A :manpage:`freebsd-update(8)` implementation for Thin Jails
fdbb78c54ffb Begin the "ftjail freebsd-update" command
Franz Glasner <fzglas.hg@dom66.de>
parents: 323
diff changeset
52
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
53 :manpage:`ftjail-mount-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
54
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
55 Canonically mount the RO base and the RW skeleton of a Thin Jail
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
56
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
57 :manpage:`ftjail-umount-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
58
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
59 Unmount mounted Thin Jail template datasets
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
60
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
61 :manpage:`ftjail-interlink-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
62
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
63 Create proper symlinks for "skeleton" style Thin Jails
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
64
307
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 301
diff changeset
65 :manpage:`ftjail-populate-tmpl(8)`
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
66
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
67 Populate a prepared directory structure with the contents of a
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
68 FreeBSD base system
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
69
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
70 :manpage:`ftjail-snapshot-tmpl(8)`
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
71
301
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
72 Recursively create ZFS snapshots of the RO base datasets and the RW
376c9f97b1cc Synchronize manpage short descriptions (between conf.py and ftjail.rst and fzfs.rst)
Franz Glasner <fzglas.hg@dom66.de>
parents: 299
diff changeset
73 skeleton datasets
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
74
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
75
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
76 Implementation Notes
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
77 --------------------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
78
307
23bcbbbd99ea FIX: Rename "ftjail-populate.rst" to "ftjail-populate-tmpl"
Franz Glasner <fzglas.hg@dom66.de>
parents: 301
diff changeset
79 All commands with the exception of :command:`ftjail populate-tmpl` and
299
49890965e43c FIX: "ftjail interlink-tmpl" also does NOT need a ZFS filesystem: document it accordingly
Franz Glasner <fzglas.hg@dom66.de>
parents: 298
diff changeset
80 :command:`ftjail interlink-tmpl` require ZFS as filesystem.
293
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
81
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
82
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
83 Environment
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
84 -----------
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
85
73ac6bec36fe Man page for "ftjail copy-jail"
Franz Glasner <fzglas.hg@dom66.de>
parents:
diff changeset
86 All environment variables that affect :command:`zfs` are effective also.
468
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
87
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
88
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
89 Examples
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
90 --------
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
91
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
92 Prepare the containers for the template datasets
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
93 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
94
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
95 Container for templates::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
96
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
97 zfs create -o canmount=off -o mountpoint=/jail/ttmpl zpool/jail/ttmpl
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
98
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
99 Sub-container for all read-only bases::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
100
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
101 zfs create -o canmount=off zpool/jail/ttmpl/base-ro
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
102
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
103 Sub-container for all read-write volumes::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
104
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
105 zfs create -o canmount=off zpool/jail/ttmpl/skel-rw
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
106
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
107
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
108 Create a new complete template for a FreeBSD distribution
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
109 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
110
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
111 Create new template datasets and populate them from a distribution archive.
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
112 The example is for FreeBSD 13.3-RELEASE::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
113
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
114 # prepare empty datasets
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
115 ftjail datasets-tmpl -P zpool/jail/ttmpl/base-ro zpool/jail/ttmpl/skel-rw 13.3-RELEASE
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
116
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
117 #
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
118 # Here you can adjust some properties (``canmount``) or create some additional
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
119 # datasets manually.
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
120 #
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
121
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
122 # mount at a temporary mountpoint
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
123 mkdir /var/tmp/13.3
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
124 ftjail mount-tmpl -P zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE /var/tmp/13.3
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
125
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
126 # populate the contents from the distribution archive
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
127 ftjail populate-tmpl -P /var/tmp/13.3 base-13.3-RELEASE.txz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
128
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
129 # If the kernel is wanted also then extract it like this
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
130 ftjail populate-tmpl -P -b /var/tmp/13.3 base-13.3-RELEASE.txt kernel-13.3-RELEASE.txz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
131
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
132 Make a named snapshot named "base" for the original::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
133
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
134 ftjail snapshot-tmpl zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE base
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
135
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
136 Also prepare the :command:`etcupdate`::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
137
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
138 ftjail build-etcupdate-current-tmpl /var/tmp/13.3 etcupdate-current-13.3@base.tbz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
139
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
140 Update to the current patch level and tag accordingly (e.g. "p5")::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
141
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
142 # Update
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
143 freebsd-update -b /var/tmp/13.3 -d /var/tmp/13.3/var/db/freebsd-update/ --currently-running 13.3-RELEASE fetch
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
144 freebsd-update -b /var/tmp/13.3 -d /var/tmp/13.3/var/db/freebsd-update/ --currently-running 13.3-RELEASE install
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
145
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
146 # Snapshot
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
147 ftjail snapshot-tmpl zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE p5
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
148
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
149 # Do not forget to prepare for etcupdate
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
150 ftjail build-etcupdate-current-tmpl /var/tmp/13.3 etcupdate-current-13.3@p5.tbz
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
151
470
c65a79d84e9e FIX: German -> englich in man
Franz Glasner <fzglas.hg@dom66.de>
parents: 468
diff changeset
152 Unmount::
468
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
153
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
154 ftjail umount-tmpl zpool/jail/ttmpl/base-ro/13.3-RELEASE zpool/jail/ttmpl/skel-rw/13.3-RELEASE
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
155
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
156
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
157 Container and Common Location for instantiated Thin Jails
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
158 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
159
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
160 All thin jails are located at :file:`/jail/TROOT`::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
161
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
162 zfs create -o mountpoint=/jail/TROOT zpool/jail/TROOT
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
163
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
164 Create the variable datasets (read-write) with the same mountpoint as above::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
165
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
166 zfs create -o canmount=off -o mountpoint=/jail/TROOT zpool/jail/TVAR
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
167
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
168
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
169 Creation of a real Thin Jail
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
170 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
171
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
172 Clone the read-only root filesystem base::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
173
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
174 zfs clone -o readonly=on zpool/jail/ttmpl/base-ro/13.3-RELEASE@p5 zpool/jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
175
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
176 If you want some additional directory (e.g. for :file:`/srv` et al.) do this
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
177 instead::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
178
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
179 zfs clone -o readonly=off zpool/jail/ttmpl/base-ro/13.3-RELEASE@p5 zpool/jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
180 # change before making it read-only
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
181 mkdir /jail/TROOT/build13/srv
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
182 zfs set readonly=on zpool/jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
183
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
184 Copy -- not clone -- the variable parts::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
185
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
186 ftjail copy-skel -P zpool/jail/ttmpl/skel-rw/13.3-RELEASE p5 zpool/jail/TVAR/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
187
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
188 Configure some important parts (as in "normal" jails)::
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
189
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
190 mount -t devfs devfs /jail/TROOT/build13/dev
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
191 fjail configure /jail/TROOT/build13
3108ce603fa1 Add usage examples for managing thin jails with the ftjail commands into the manual page of ftjail
Franz Glasner <fzglas.hg@dom66.de>
parents: 374
diff changeset
192 umount /jail/TROOT/build13/dev