diff options
-rw-r--r-- | stories/projects/ezjail.rst | 46 |
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 | |||
168 | Since 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): | 168 | Since 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 |