summaryrefslogtreecommitdiff
path: root/stories/projects/ezjail.rst
diff options
context:
space:
mode:
Diffstat (limited to 'stories/projects/ezjail.rst')
-rw-r--r--stories/projects/ezjail.rst46
1 files changed, 27 insertions, 19 deletions
diff --git a/stories/projects/ezjail.rst b/stories/projects/ezjail.rst
index b25b025..955baa6 100644
--- a/stories/projects/ezjail.rst
+++ b/stories/projects/ezjail.rst
@@ -168,11 +168,18 @@ Version History
168Since ezjail is useful under FreeBSD only, you might want to install it from ports ``sysutils/ezjail``. An `ezjail cvsweb (deprecated) </cvsweb/ezjail/>`_ and `ezjail gitweb </gitweb/ezjail/>`_ are available, plus there is a `fresh checkout <ezjail/>`_. The most current version is available via cvs. Use ``git clone git://erdgeist.org/ezjail`` or the legacy view ``cvs -d :pserver:anoncvs@cvs.erdgeist.org:/home/cvsroot co ezjail`` with an empty passwort to check it out. Just type ``sudo make install`` to install it. Older versions may be found here (checksums in tooltips): 168Since ezjail is useful under FreeBSD only, you might want to install it from ports ``sysutils/ezjail``. An `ezjail cvsweb (deprecated) </cvsweb/ezjail/>`_ and `ezjail gitweb </gitweb/ezjail/>`_ are available, plus there is a `fresh checkout <ezjail/>`_. The most current version is available via cvs. Use ``git clone git://erdgeist.org/ezjail`` or the legacy view ``cvs -d :pserver:anoncvs@cvs.erdgeist.org:/home/cvsroot co ezjail`` with an empty passwort to check it out. Just type ``sudo make install`` to install it. Older versions may be found here (checksums in tooltips):
169 169
170* CURRENT - not packaged yet 170* CURRENT - not packaged yet
171* V3.4.1 ezjail-3.4.1.tar.bz2 (2014-06-10) 171* V3.4.2 `<ezjail-3.4.2.tar.bz2>`_ (2015-11-23)
172 172
173 * Fixed a fatal bug in unfinished parts of the new troubleshoot subcommand 173 * Fixed a bug where ezjail-admin install would fail if the lib32 package is not there.
174 * Add an experimental freeze feature, where you can automatically create flavours by letting ezjail inspect the changes in a jail's zfs.
175 * Fix a bug in date-string creation (reported by kaltheat).
176 * If a zfs jail is forcefully destroyed, also destroy its underlying file system, if there are errors.
174 177
175* V3.4 ezjail-3.4.tar.bz2 (2014-06-10) 178* V3.4.1 `<ezjail-3.4.1.tar.bz2>`_ (2014-06-10)
179
180 * Fixed a fatal bug in unfinished parts of the new troubleshoot subcommand.
181
182* V3.4 `<ezjail-3.4.tar.bz2>`_ (2014-06-10)
176 183
177 * Began a troubleshoot subcommand that will in future check for unintuitive reasons for the jails to fail. 184 * Began a troubleshoot subcommand that will in future check for unintuitive reasons for the jails to fail.
178 * Fixed a bug where Jails configured .norun were reported failing to start with the ezjail-admin start subcommand. Thanks to John Grasty. 185 * Fixed a bug where Jails configured .norun were reported failing to start with the ezjail-admin start subcommand. Thanks to John Grasty.
@@ -183,7 +190,8 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
183 * Fixed a bug where ezjail-admin delete and ezjail-admin config would not find the zpool the jail was created in. 190 * Fixed a bug where ezjail-admin delete and ezjail-admin config would not find the zpool the jail was created in.
184 * Implemented a jail snapshot mechanism for zfs jails with configurable retention policy. 191 * Implemented a jail snapshot mechanism for zfs jails with configurable retention policy.
185 * Fixed a bug where ezjail-admin restore with a path to an archive would not use the correct jail name and thus fail. Thanks to Ollivier Robert. 192 * Fixed a bug where ezjail-admin restore with a path to an archive would not use the correct jail name and thus fail. Thanks to Ollivier Robert.
186* V3.3 ezjail-3.3.tar.bz2 (2013-04-20) 193
194* V3.3 `<ezjail-3.3.tar.bz2>`_ (2013-04-20)
187 195
188 * Due to recent circumstances, I added a license file. 196 * Due to recent circumstances, I added a license file.
189 * Properly handle ip addresses with prefixed interface names, so they appear readable in the jail list and they will not be checked for on ezjail-admin create. Since FreeBSD 9.0 you can configure ip addresses with interface prefix (e.g. em1|10.0.0.1). This feature of jail(8) is now also documented in the ezjail's man pages. 197 * Properly handle ip addresses with prefixed interface names, so they appear readable in the jail list and they will not be checked for on ezjail-admin create. Since FreeBSD 9.0 you can configure ip addresses with interface prefix (e.g. em1|10.0.0.1). This feature of jail(8) is now also documented in the ezjail's man pages.
@@ -194,15 +202,15 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
194 * ezjail-admin update and ezjail-admin upgrade now call freebsd-update install until no more update steps are necessary. Previously upgrades were not installed completely, as freebsd-update uses several passes. 202 * ezjail-admin update and ezjail-admin upgrade now call freebsd-update install until no more update steps are necessary. Previously upgrades were not installed completely, as freebsd-update uses several passes.
195 * Now properly support the new distributions layout. 203 * Now properly support the new distributions layout.
196 * Do not run chflags -R noschg when deleting image jails. The whole file system is being thrown away, anyway. Thanks to tomster. 204 * Do not run chflags -R noschg when deleting image jails. The whole file system is being thrown away, anyway. Thanks to tomster.
197* V3.2.3 ezjail-3.2.3.tar.bz2 (2012-09-23) 205* V3.2.3 `<ezjail-3.2.3.tar.bz2>`_ (2012-09-23)
198 206
199 * Fixed a bug that made ezjail-admin update not find the source tree. Thanks to Paul Macdonald. 207 * Fixed a bug that made ezjail-admin update not find the source tree. Thanks to Paul Macdonald.
200 * Fixed ezjail-admin console to not start all jails when the -f option is requested. 208 * Fixed ezjail-admin console to not start all jails when the -f option is requested.
201* V3.2.2 ezjail-3.2.2.tar.bz2 (2012-09-10) 209* V3.2.2 `<ezjail-3.2.2.tar.bz2>`_ (2012-09-10)
202 210
203 * Jails can now default to being created in zfs, set ezjail_use_zfs_for_jails="YES" in your ezjail.conf to do that. 211 * Jails can now default to being created in zfs, set ezjail_use_zfs_for_jails="YES" in your ezjail.conf to do that.
204 * Cleaned up the zfs code to ensure the ezjail zfs in a central place. 212 * Cleaned up the zfs code to ensure the ezjail zfs in a central place.
205* V3.2.1 ezjail-3.2.1.tar.bz2 (2012-02-02) 213* V3.2.1 `<ezjail-3.2.1.tar.bz2>`_ (2012-02-02)
206 214
207 * Fixed ezjail-admin list to work properly without jails. 215 * Fixed ezjail-admin list to work properly without jails.
208 * A helper script ezjail-clone.sh has been added to the repository that aids in importing whole server setups into an ezjail-system. 216 * A helper script ezjail-clone.sh has been added to the repository that aids in importing whole server setups into an ezjail-system.
@@ -211,7 +219,7 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
211 * Fixed a bug where pids not belonging to a Jail were reported as jailed. Thanks to Thomas Steen Rasmussen. 219 * Fixed a bug where pids not belonging to a Jail were reported as jailed. Thanks to Thomas Steen Rasmussen.
212 * Fixed a bug in ezjail-admin delete -f where all Jails were stopped, not only the one to be deleted. Tanks to Thomas Steen Rasmussen. 220 * Fixed a bug in ezjail-admin delete -f where all Jails were stopped, not only the one to be deleted. Tanks to Thomas Steen Rasmussen.
213 * Fixed a bug in ezjail-admin create that overwrote all flavours scripts with the successor by not counting the flavours correctly. Thanks to Geoffroy Desvernay. 221 * Fixed a bug in ezjail-admin create that overwrote all flavours scripts with the successor by not counting the flavours correctly. Thanks to Geoffroy Desvernay.
214* V3.2 ezjail-3.2.tar.bz2 (2012-01-07) 222* V3.2 `<ezjail-3.2.tar.bz2>`_ (2012-01-07)
215 223
216 * The man pages have been completely rewritten and are much easier to understand now. 224 * The man pages have been completely rewritten and are much easier to understand now.
217 * Default archive location now is ezjail_archives under ezjail_jaildir. Before it defaulted to the current directory. 225 * Default archive location now is ezjail_archives under ezjail_jaildir. Before it defaulted to the current directory.
@@ -229,7 +237,7 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
229 * Fix one misspelling that wrongly reported success for attaching a console to a Jail not running. 237 * Fix one misspelling that wrongly reported success for attaching a console to a Jail not running.
230 * The ezjail rc script now correctly also re-attaches images on restart. 238 * The ezjail rc script now correctly also re-attaches images on restart.
231 * There now is a Jail name auto completion script for zsh. 239 * There now is a Jail name auto completion script for zsh.
232* V3.1 ezjail-3.1.tar.bz2 (2010-02-26) 240* V3.1 `<ezjail-3.1.tar.bz2>`_ (2010-02-26)
233 241
234 * Introduced support for creating ezjails and the basejail in ZFS file systems. 242 * Introduced support for creating ezjails and the basejail in ZFS file systems.
235 * Attaching ZFS-datasets to ezjails is now supported. 243 * Attaching ZFS-datasets to ezjails is now supported.
@@ -242,7 +250,7 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
242 * Renamed the default flavour to example to avoid confusion. default flavour was never applied by default. 250 * Renamed the default flavour to example to avoid confusion. default flavour was never applied by default.
243 * ezjail-admin create and ezjail-admin config no longer fail if they can't create a soft link in ezjail_jaildir. They now use mktemp to get a unique one. 251 * ezjail-admin create and ezjail-admin config no longer fail if they can't create a soft link in ezjail_jaildir. They now use mktemp to get a unique one.
244 * ezjail-admin create now allow multiple flavours to be applied to new jails. They are executed in the order provided with the -f option. 252 * ezjail-admin create now allow multiple flavours to be applied to new jails. They are executed in the order provided with the -f option.
245* V3.0 ezjail-3.0.tar.bz2 (2008-09-26) 253* V3.0 `<ezjail-3.0.tar.bz2>`_ (2008-09-26)
246 254
247 * Introduced an ezjail-admin restore command that can be used to easily deploy a backed up version of an ezjail's archive. 255 * Introduced an ezjail-admin restore command that can be used to easily deploy a backed up version of an ezjail's archive.
248 * Introduced an ezjail-admin archive command that – accompanied by the newly introduced create -a option – can be used to take (automated) backups of your jails and reinstall them. 256 * Introduced an ezjail-admin archive command that – accompanied by the newly introduced create -a option – can be used to take (automated) backups of your jails and reinstall them.
@@ -260,7 +268,7 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
260 268
261.. class:: closed 269.. class:: closed
262 270
263* V2.1. ezjail-2.1.tar.bz2 (2007-07-31) 271* V2.1. `<ezjail-2.1.tar.bz2>`_ (2007-07-31)
264 272
265 * Introduced a ezjail-admin config -n newname sub command to enable renaming jails. 273 * Introduced a ezjail-admin config -n newname sub command to enable renaming jails.
266 * Introduced a ezjail-admin config -i fsck sub command to fsck images. 274 * Introduced a ezjail-admin config -i fsck sub command to fsck images.
@@ -273,12 +281,12 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
273 * ezjail.sh now also checks for root directory to prevent strange effects in /etc/rc.d/jail. 281 * ezjail.sh now also checks for root directory to prevent strange effects in /etc/rc.d/jail.
274 * Default flavours /etc/periodic.conf now makes all periodic scripts log to files instead of sending mails. Most often this is what you want in your jails. 282 * Default flavours /etc/periodic.conf now makes all periodic scripts log to files instead of sending mails. Most often this is what you want in your jails.
275 * Started learning groff and went over man pages. Not many visible changes here. 283 * Started learning groff and went over man pages. Not many visible changes here.
276* V2.0.1 ezjail-2.0.1.tar.bz2 (2006-07-24) 284* V2.0.1 `<ezjail-2.0.1.tar.bz2>`_ (2006-07-24)
277 285
278 * DESTDIR was ignored for sub targets in an ezjail-admin update -p under certain circumstances. See this report for more details. Thanks go to Simon L. Nielsen. 286 * DESTDIR was ignored for sub targets in an ezjail-admin update -p under certain circumstances. See this report for more details. Thanks go to Simon L. Nielsen.
279 * Fixed some qoutation/expansion issues with tr parameters in the form [:alnum:] which were expanded to the files : a l n u and m, if existing. Also an apparent bug in tr was circumvented which incorrectly replaced A-Z to a-z in certain LANG settings. Thanks agains to Simon L. Nielsen. 287 * Fixed some qoutation/expansion issues with tr parameters in the form [:alnum:] which were expanded to the files : a l n u and m, if existing. Also an apparent bug in tr was circumvented which incorrectly replaced A-Z to a-z in certain LANG settings. Thanks agains to Simon L. Nielsen.
280 * ezjail_ftphost was ignored when specified in PREFIX/etc/ezjail.conf. Thanks to Edwin Groothuis. 288 * ezjail_ftphost was ignored when specified in PREFIX/etc/ezjail.conf. Thanks to Edwin Groothuis.
281* V2.0 ezjail-2.0.tar.bz2 (2006-05-31) 289* V2.0 `<ezjail-2.0.tar.bz2>`_ (2006-05-31)
282 290
283 * The default way to create the basejail will become the newly introduced ezjail-admin install subcommand. In its default configuration the base system is fetched from an ftp-Server. Fetching ports, source, man pages is possible with -p, -s and -m switch. Implementing this feature finally brings the promised ease of use and allows: cd /usr/ports/sysutils/ezjail; make install; ezjail-admin install; ezjail-admin create test.com 10.1.1.1 on a vanilla FreeBSD server, i.e. without installing /usr/src. 291 * The default way to create the basejail will become the newly introduced ezjail-admin install subcommand. In its default configuration the base system is fetched from an ftp-Server. Fetching ports, source, man pages is possible with -p, -s and -m switch. Implementing this feature finally brings the promised ease of use and allows: cd /usr/ports/sysutils/ezjail; make install; ezjail-admin install; ezjail-admin create test.com 10.1.1.1 on a vanilla FreeBSD server, i.e. without installing /usr/src.
284 * A new concept of how to manage your Jails has been introduced: Image Jails. They come in plain, gbde and geli encrypted. ezjail-admin create, ezjail-admin delete and ezjail.sh have been updated to provide the functionality needed. 292 * A new concept of how to manage your Jails has been introduced: Image Jails. They come in plain, gbde and geli encrypted. ezjail-admin create, ezjail-admin delete and ezjail.sh have been updated to provide the functionality needed.
@@ -290,18 +298,18 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
290 * ezjail.sh now excludes Jail configs whose file name contain '.' (dots). This way it is possible to configure a Jail config test_org.norun to temporary exclude it from auto run process. 298 * ezjail.sh now excludes Jail configs whose file name contain '.' (dots). This way it is possible to configure a Jail config test_org.norun to temporary exclude it from auto run process.
291 * ezjail introduces an option ezjail_uglyperlhack (defaults to YES) which creates a soft link from /usr/bin/perl to /usr/local/bin/perl in the base jail. This is useful since perl was expelled from base system in FreeBSD 5 but still many scripts rely on #!/usr/bin/perl. 299 * ezjail introduces an option ezjail_uglyperlhack (defaults to YES) which creates a soft link from /usr/bin/perl to /usr/local/bin/perl in the base jail. This is useful since perl was expelled from base system in FreeBSD 5 but still many scripts rely on #!/usr/bin/perl.
292 * /usr/games and /usr/libdata have now become part of the basejail. Someone please kick me for missing that until now. Saves another 100k in newjail. Hopefully I got them all by now ;) Thanks to Vivek Khera. 300 * /usr/games and /usr/libdata have now become part of the basejail. Someone please kick me for missing that until now. Saves another 100k in newjail. Hopefully I got them all by now ;) Thanks to Vivek Khera.
293* V1.3.1 ezjail-1.3.1.tar.bz2 (2006-03-13) 301* V1.3.1 `<ezjail-1.3.1.tar.bz2>`_ (2006-03-13)
294 302
295 * ezjail.sh did not ignore the jail_list from rc.conf as it should due to a legacy name space clash. This led to no ezjail being started at system startup when some non-ezjail-Jails exist in the system. Thanks to Cryx. 303 * ezjail.sh did not ignore the jail_list from rc.conf as it should due to a legacy name space clash. This led to no ezjail being started at system startup when some non-ezjail-Jails exist in the system. Thanks to Cryx.
296 * ezjail-admin now prevents a Jail called fulljail to be created and refines the error message in case the user wants to create basejail, newjail or flavours. 304 * ezjail-admin now prevents a Jail called fulljail to be created and refines the error message in case the user wants to create basejail, newjail or flavours.
297 * ezjail-admin now again allows recreating Jails with the -x option. This was broken when introducing the Jail root check in V 1.3. Thanks to Mike Harding. 305 * ezjail-admin now again allows recreating Jails with the -x option. This was broken when introducing the Jail root check in V 1.3. Thanks to Mike Harding.
298 * An experimental script ezjail-release.sh has been added to CVS which allows creating the basejail from FreeBSD ftp-Server. However, this script has known issues, like updating existing basejail's ports does not remove obsolete files, also there is no documentation. 306 * An experimental script ezjail-release.sh has been added to CVS which allows creating the basejail from FreeBSD ftp-Server. However, this script has known issues, like updating existing basejail's ports does not remove obsolete files, also there is no documentation.
299* V1.3 ezjail-1.3.tar.bz2 (2006-02-16) 307* V1.3 `<ezjail-1.3.tar.bz2>`_ (2006-02-16)
300 308
301 * Removed an ugly shell variable quoting bug that led to ezjail.sh fail for multiple jails. Thanks to Alex Moura. PLEASE UPDATE FROM 1.2 as fast as possible. 309 * Removed an ugly shell variable quoting bug that led to ezjail.sh fail for multiple jails. Thanks to Alex Moura. PLEASE UPDATE FROM 1.2 as fast as possible.
302 * ezjail-admin create now checks, whether a given Jail root already exists and refuses to install. Thanks to Mark Bucciarelli for finding this one. 310 * ezjail-admin create now checks, whether a given Jail root already exists and refuses to install. Thanks to Mark Bucciarelli for finding this one.
303 * /boot and /rescue have now become part of the basejail. Someone please kick me for missing that until now. New jails now are < 2 MB in size. 311 * /boot and /rescue have now become part of the basejail. Someone please kick me for missing that until now. New jails now are < 2 MB in size.
304* V1.2 ezjail-1.2.tar.bz2 (2006-02-10) 312* V1.2 `<ezjail-1.2.tar.bz2>`_ (2006-02-10)
305 313
306 * A subsystem providing auto configuration on Jail has been created. You may specify flavours at Jail creation. See section Flavours. 314 * A subsystem providing auto configuration on Jail has been created. You may specify flavours at Jail creation. See section Flavours.
307 * ezjail-admin update now allows cvs co or cvs up of ports in the basejail by providing the -p or -P option. 315 * ezjail-admin update now allows cvs co or cvs up of ports in the basejail by providing the -p or -P option.
@@ -313,20 +321,20 @@ Since ezjail is useful under FreeBSD only, you might want to install it from por
313 * ezjail-admin create now replaces any character in Jail name not suitable for shell variables by underscore. This leads to the situation that two jails must not have identical names after them being piped through tr -c [:alnum:] _, thanks go to Gunjin. 321 * ezjail-admin create now replaces any character in Jail name not suitable for shell variables by underscore. This leads to the situation that two jails must not have identical names after them being piped through tr -c [:alnum:] _, thanks go to Gunjin.
314 * A default installation PREFIX is provided now. Installing to / seems not too useful and should not be default. 322 * A default installation PREFIX is provided now. Installing to / seems not too useful and should not be default.
315 * Documentation has been rewritten and simplified a lot. 323 * Documentation has been rewritten and simplified a lot.
316* V1.1 ezjail-1.1.tar.bz2 (2005-10-26) 324* V1.1 `<ezjail-1.1.tar.bz2>`_ (2005-10-26)
317 325
318 * minor typo in ezjail.sh, changed #/bin/sh to #!/bin/sh, thanks go to Alex Samorukov. 326 * minor typo in ezjail.sh, changed #/bin/sh to #!/bin/sh, thanks go to Alex Samorukov.
319 * Makefile ensures that all directories are there when installing. Helps with odd $PREFIXes 327 * Makefile ensures that all directories are there when installing. Helps with odd $PREFIXes
320 * ezjail-admin now creates $basejail/usr itself, since cpio creates missing intermediate directories in 0700 which is bad 328 * ezjail-admin now creates $basejail/usr itself, since cpio creates missing intermediate directories in 0700 which is bad
321 * ezjail-admin now verifies the existence of its basejail before creating Jails 329 * ezjail-admin now verifies the existence of its basejail before creating Jails
322* V1.0 ezjail-1.0.tar.bz2 (2005-10-14) 330* V1.0 `<ezjail-1.0.tar.bz2>`_ (2005-10-14)
323 331
324 * first release 332 * first release
325 * made FreeBSD port for ezjail 333 * made FreeBSD port for ezjail
326 * actually implemented ezjail-admin delete feature 334 * actually implemented ezjail-admin delete feature
327 * documentation completed 335 * documentation completed
328 * lots of bug fixes I can't remember anymore, however V0.1 has never been used by anyone but me 336 * lots of bug fixes I can't remember anymore, however V0.1 has never been used by anyone but me
329* V0.1 ezjail-0.1.tar.bz2 (2005-09-26) 337* V0.1 `<ezjail-0.1.tar.bz2>`_ (2005-09-26)
330 338
331 * highly experimental version 339 * highly experimental version
332 * first real world testing on a server system with >20 jails 340 * first real world testing on a server system with >20 jails