The Labs.Com OS Lab FreeBSD Jail Tools fbsd_jails Webmin

The Labs - Design & Functionality For The Net

fbsd_jails: Webmin module to handle Jails

1. Introduction
2. Download
3. Screenshots

This webmin-module to handle jails under FreeBSD and the Jail Tools.

jail is available since FreeBSD-4.0 and permits to encapsulate one or more processes within a 'jail', a sort of virtualization of a machine is possible. In order to use a jail some preparations are required.

The Jail Tools provide the base functionality, and this webmin module provides and simple Web GUI to handle dozens of jails to

• add,
• install,
• start,
• stop,
• deinstall and
• delete again.

Two main installation types are available, either

• shared disk where the host disk is shared, or
• dedicated disk where a file-based disk is used, which enables to copy, backup and restore a jail system disk easily.

Additional virtual X11-screens can be attached to each jail using Xvnc (part of VNC).

fbsd_jails Webmin 2. Download

HISTORY 2005/04/17: 0.022: mount /proc if required 2004/12/24: 0.020: FreeBSD-5.3 considers hostname as jailname, update /etc/rc.conf hostname as well 2004/11/23: 0.019: bug fix when multiple ethernet cards are available 2004/11/20: 0.018: dedicated disk bug fix (when ip is changed) 2004/07/25: 0.017: ip & alias editable 2004/06/28: 0.016: small bug fix in sprintf 2004/03/08: 0.015: bug fixes: install and delete fixed 2004/02/23: 0.014: misc improvments, warning over non-existing jail-root, also better support for unnamed jails (created by jail_install but not the web-gui) 2004/02/23: 0.013: jail_ro_usr support (jail_tools-0.07 required) 2004/02/22: 0.012: small bug fix (global config doesn't clear special settings) 2004/02/17: 0.011: virtual x11 for each jail (using Xvnc) 2004/02/12: 0.010: additional host information in the overview 2004/02/10: 0.009: update comment, services and autostart (jailtab) 2004/02/06: 0.008: deinstall & delete are two different things 2004/02/06: 0.007: new feature with file-based disks for jails (requires jail_tools-0.05 at least) 2003/11/11: 0.006: global configuration editable 2003/11/02: 0.004: various improvements and small bug fixes 2003/10/24: 0.001: started to code it

fbsd_jails-0.022.wbm License: GPL, Supported OS: FreeBSD 4.x & FreeBSD 5.x, Requirements: WebMin installed e.g. via /usr/ports/sysutils/webmin/, and jail_tools (at least 0.07).

fbsd_theme-0.006.wbt FreeBSD Web Console Theme Requirements: WebMin License: GPL Installation: "Webmin" -> "Webmin Configuration" -> "Webmin Theme" and paste URL there.

Hints:

• Best install it via webmin itself (Webmin -> Webmin Configuration -> Webmin Modules). If you plan to untar it yourself (.wbm is just a .tar file), do it in /usr/local/lib/webmin/, and copy fbsd_jails/config to /usr/local/etc/webmin/webmin/fbsd_jails/.
• Enable 'admin' to use fbsd_jails module: Webmin -> Webmin Users -> User: 'admin' -> enable 'FreeBSD Jails' in the list.
• By default "FreeBSD Jails" module is listed under category 'Others'.
• Install latest Jail Tools always when you update fbsd_jails.
• Use FreeBSD Web Console Theme (mentioned above) (Webmin -> Webmin Configuration -> Webmin Themes).

fbsd_jails Webmin 3. Screenshots

Jails Overview #1: Jails Overview #2: Jail Detail: Jail Add: Jail Install: History Log:

                                                                                                                                   

Jail Tools Cookbook

Jail Tools