Update to r51462:

Document jail.conf Jail configuration

jail.conf is the preferred method of configuring jails in all supported
FreeBSD versions.  Older rc.conf(5) configuration produces a warning.
Update the handbook example to match based on the submission in the PR,
with a few modifications.
This commit is contained in:
Bjoern Heidotting 2018-05-13 19:51:01 +00:00
parent 92f9df08ff
commit 0f96279a10
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=51651

View file

@ -5,7 +5,7 @@
$FreeBSD$
$FreeBSDde: de-docproj/books/handbook/jails/chapter.xml,v 1.23 2011/05/25 20:42:25 jkois Exp $
basiert auf: r51447
basiert auf: r51462
-->
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
@ -376,48 +376,43 @@
<procedure>
<step>
<para>Eine Liste der Jails, die mit dem Betriebssystem
gestartet werden sollen, wird in die Datei &man.rc.conf.5;
geschrieben:</para>
<para>Konfigurieren Sie die Jail in
<filename>/etc/jail.conf</filename>:</para>
<programlisting>jail_enable="YES" # Set to NO to disable starting of any jails
jail_list="<replaceable>www</replaceable>" # Space separated list of names of jails</programlisting>
<programlisting><replaceable>www</replaceable> {
host.hostname = <replaceable>www.example.org</replaceable>; # Hostname
ip4.addr = <replaceable>192.168.0.10</replaceable>; # IP address of the jail
path = "<replaceable>/usr/jail/www</replaceable>"; # Path to the jail
devfs.ruleset = "<replaceable>www_ruleset</replaceable>"; # devfs ruleset
mount.devfs; # Mount devfs inside the jail
exec.start = "/bin/sh /etc/rc"; # Start command
exec.stop = "/bin/sh /etc/rc.shutdown"; # Stop command
}</programlisting>
<note>
<para>Die Namen der Jails in der
<varname>jail_list</varname> sollten nur alphanumerische
Zeichen enthalten.</para>
</note>
</step>
<para>Um die Jails mit dem Betriebssystem zu starten, fügen
Sie folgende Zeile in
<filename>/etc/rc.conf</filename> ein:</para>
<step>
<para>Für jede Jail in der <varname>jail_list</varname>
sollten in &man.rc.conf.5; einige Einstellungen
vorgenommen werden:</para>
<programlisting>jail_enable="YES" # Set to NO to disable starting of any jails</programlisting>
<programlisting>jail_<replaceable>www</replaceable>_rootdir="/usr/jail/www" # jail's root directory
jail_<replaceable>www</replaceable>_hostname="<replaceable>www</replaceable>.example.org" # jail's hostname
jail_<replaceable>www</replaceable>_ip="192.168.0.10" # jail's IP address
jail_<replaceable>www</replaceable>_devfs_enable="YES" # mount devfs in the jail</programlisting>
<para>Beim Start einer in &man.rc.conf.5; konfigurierten Jail
<para>Beim Start einer in &man.jail.conf.5; konfigurierten Jail
wird das <filename>/etc/rc</filename>-Skript der Jail (das
"annimmt", dass es sich in einem kompletten System befindet)
aufgerufen. Für Service-Jails sollten die Startskripte
der Jail durch das Setzen der Option
<varname>jail_<replaceable>jailname</replaceable>_exec_start</varname>
<varname>exec.start</varname>
entsprechend angepasst werden.</para>
<note>
<para>Eine vollständige Liste der Optionen findet sich
in der Manualpage zu &man.rc.conf.5;.</para>
in der Manualpage &man.jail.conf.5;.</para>
</note>
</step>
</procedure>
<para>&man.service.8; kann zum manuellen Starten und Stoppen der
Jail genutzt werden, wenn ein Eintrag in
<filename>rc.conf</filename> angelegt wurde:</para>
<filename>jail.conf</filename> angelegt wurde:</para>
<screen>&prompt.root; <userinput>service jail start <replaceable>www</replaceable></userinput>
&prompt.root; <userinput>service jail stop <replaceable>www</replaceable></userinput></screen>