From nobody Tue Jan 28 14:52:22 2025 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Yj7YM03Kvz5lZ76 for ; Tue, 28 Jan 2025 14:52:23 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Yj7YL5mXFz3d0f for ; Tue, 28 Jan 2025 14:52:22 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1738075942; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=jDMAfX2mV4x70Te2Ovxx9Mm4faEAwYqz0LnCx+rO70k=; b=EK+EjaqLvX+6g5ecwRjceQd86BBcb2aUx92GpgI2QecfCd1VmE4uIiQmx8tmz6JGI/1yNG 0TOQ7DT3WZPCAJK1Wf01V5DxLZywn2KG2E4AGRzxU9cnteOEOlVa8t65MNEXd2dyqd/bR2 kWsLuHEtVDaQOpt6XQCDl3Ydu/Jx758TMZZgAq/xtR96w7TqhpDW8SF4Usg0wOyceYnlcC 9HNKlmR0dyUgA89AqjeELz1+DJm6X2PcDNkWbr+SS7vz5iMA8/ECjPnMkJujx95xcczyvr 1L+RfIU6K+IT849Ax9ZZbP3X+hzT7UhYoIVFVMLgsR+EUGP4s1R+a7uax41anw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1738075942; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=jDMAfX2mV4x70Te2Ovxx9Mm4faEAwYqz0LnCx+rO70k=; b=S33F5hftmbqkkbdX4oJQGL3XPtFDkSkruWtGiZUpfSE1oru/3G/txRu0RfBKqIOovTDA+z QWjn0y+Lx0Bg4TPRTl2Z8f9wx2uRhfJCCKn2//bbzAX6pUU6vzBuGwV4OuKozHj7bsqT20 zoqFWpMRmFcHzQ3UBTLxOHkEpzCOktGoqjXUUnRliRJY+nvFQJbOEs6HdxakUkbekdcx+l KWdhVSwW1U4TOGSpvWib4HaTyhVBQ42h4e4Q73AiQDdXTCp0NNHGGL3v92c/R0Sv6aesgX IpU5H2h95Gfqba74N/dMEKtEyuMAENDbLasc6ezKruJU0mjmoBLafRFz9QVyYw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1738075942; a=rsa-sha256; cv=none; b=x0v0P0YFgPHpIBTQYrpblNw1VvaWnQpgdZGBieOK17GYrBpWDW4mHAMaf8GbQ1HF4DVUJI eogeXqRXP/Gd801RD/w2KdsFXinxVnQOFKYVoAJYewZsksO8Pj56ockhDgGV2a9b6t0mqJ A8l1SkdjRBpKhBmMIFWV6kZbmDiWfl2nBrJplk1lH9m3XLS5gSTcTbFBysbFNYg3meXQXF j7o8gS6FfyEBBjQ2qM+VptSedQPL59e9XSUi4mvGtQts3UNjHEcy07vDPABxdAjkGaE5hA s4Pr8bW3x+/3PQBm4tAAkGxe35dnsAvrkUbDggHyITDgsxZUcCmGw9j/feNLhA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Yj7YL5Kqpz3yF for ; Tue, 28 Jan 2025 14:52:22 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 50SEqM4p031050 for ; Tue, 28 Jan 2025 14:52:22 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 50SEqMo7031049 for doc@FreeBSD.org; Tue, 28 Jan 2025 14:52:22 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 284410] [handbook] Thinjail creation steps with ZFS are incomplete/incorrect Date: Tue, 28 Jan 2025 14:52:22 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Website X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: andy@codeedog.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter Message-ID: Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="UTF-8" X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@FreeBSD.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D284410 Bug ID: 284410 Summary: [handbook] Thinjail creation steps with ZFS are incomplete/incorrect Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Many People Priority: --- Component: Website Assignee: doc@FreeBSD.org Reporter: andy@codeedog.com Referring to Handbook, Section 17.5.1. Creating a Thin Jail Using OpenZFS Snapshots Following these steps with a fresh install of 14.2_RELEASE fails at a numbe= r of points. Directories and/or datasets aren't created along the way that are required and the final jail.conf file contains a path (under # HOSTNAME/PAT= H) that doesn't exist (wasn't created) during the step-by-step instructions. The missing steps require some deeper knowledge of ZFS to understand how to correct (how to set a mount point on a dataset), or the instructions should= be adjusted to work with the created dataset(s). I would think the former woul= d be preferable because the latter implies jails won't be in the usual (expected) directory location. Here are the steps I used to successfully create a thin jail with ZFS: # Create zroot/jails dataset with a mountpoint of /usr/local/jails/ # See footnote[1] zfs create -p zroot/jails -o mountpoint=3D/usr/local/jails # Fetch media zfs create zroot/jails/media fetch https://download.freebsd.org/ftp/releases/amd64/amd64/14.2-RELEASE/base.txz= -o /usr/local/jails/media/14.2-RELEASE-base.txz # Start template creation from media zfs create -p zroot/jails/templates/14.2-RELEASE tar -xf /usr/local/jails/media/14.2-RELEASE-base.txz -C /usr/local/jails/templates/14.2-RELEASE --unlink # copy minimal files cp /etc/resolv.conf /usr/local/jails/templates/14.2-RELEASE/etc/resolv.conf cp /etc/localtime /usr/local/jails/templates/14.2-RELEASE/etc/localtime # update freebsd-update -b /usr/local/jails/templates/14.2-RELEASE/ fetch install # complete template with a snapshot for thinjail reuse zfs snapshot zroot/jails/templates/14.2-RELEASE@base # Create dataset to hold thin jails zfs create zroot/jails/containers # FINALLY, create the thin jail from the template zfs clone zroot/jails/templates/14.2-RELEASE@base zroot/jails/containers/thinjail # Create /etc/jails.conf.d/thinjail.conf ------ [1] - Perhaps handbook shows the result of zfs-list after mountpoint creati= on. eg: zfs list zroot/jails NAME USED AVAIL REFER MOUNTPOINT zroot/jails 914M 887G 96K /usr/local/jails --=20 You are receiving this mail because: You are the assignee for the bug.=