FreeBSD Documentation: An Interview with Tom Rhodes
An Anonymous Coward writes "FreeBSD has been known for excellent documentation and here is a rare sneak peak behind the scenes of the FreeBSD document project with FreeBSD's very own Tom Rhodes."
I have a question for those interested in FreeBSD documentation:
Let's say you have a production environment running FreeBSD 5.x (I know, boo, hiss, only -RELEASE, not -STABLE...blah blah blah), and with the upcoming release of 5.3-STABLE (my understanding anyway), how would you recommend a minimal downtime upgrade?
I have 2 nameservers running the stock Bind8, 2 MX's running stock sendmail. One 'users' box running Sendmail with spamassassin and spamassassin milter, along with apache2 and squirrelmail for webmail.
None of these boxes have the full sources installed, and in the past I've taken the boxes down and done a binary upgrade from CD. Is this the fastest method?
Karma: Chameleon (mostly due to the fact that you come and go).
FreeBSD is dead!
As someone who has used multiple Un*x-like OSes, such as FreeBSD, OpenBSD, Gentoo Linux, Debian GNU/Linux (and I am not a zealot for any of them - imagine that!), and others, I have found that if I want to know about saomething or how to do something, FreeBSD has always been the best at having the information availiable. It is very easy to find what I need to know, and everything seems done very logically. Good Job, guys!
Nearly 2.5 Million Active Sites running FreeBSD
Now I am trying to get a bootable 5.2.1 cdrom. I finally found section 16 of the manual, which describes cdboot. It doesnt really say much else in the way of what do I need to put in the loader.rc file, if anything, or do I need one. It doesn't say if I need to have just cdboot or also boot0 and the loader. Doing just what they suggested left me with a none bootable cdrom.
I'd like to know more information on what I need to do to the boot directory to get a working bootable cdrom. Well I should give it some credit, it does boot, but then it stops and says could not find / . Do I need to specify load /kernel in the loader.rc?
I will say one thing, using cd-rw's and bochs has saved me a few cd-r's.
Only 'flamers' flame!
Does slashdot hate my posts?
Thankyou to all the folks that have created the world-class documentation system to go with the world-class OS that is FreeBSD.
*thumbs up*
do() || do_not();
Tom Rhodes seems to have a personal agenda to push against the DragonFlyBSD developers (specially David Rhodus). It would be nice if he and his friends DES and Bosko stopped doing that. The fantastic 4 (the former three + Poul-Henning Kamp) have alienated a lot of people already and deprived FreeBSD of valuable contributors.
Doug-Furlong Smorgreff
FreeBSD & DragonFlyBSD are great projects led by top notch developers, they both rule.
You, on the other hand, suck.
Get a life, moron - or, better, learn to code, before going around defaming people who can.
Otherwise, the Troll isn't giving back his enhancements!
P.S. He sold 2,000 copies of a *beta* system! :-D
[nt]
It's appeared in the old documentation, but doesn't appear in the new documentation, so why?
open4free ©
I'm glad you brought that up. I've been so long out of a well supported branch that I forgot about Software Update entirely. I agree with your assessment. Those who are on well populated branches of the code tree are best served by FreeBSD Update for security. Since security is a moving target, running on a STABLE branch and keeping up to date is the best way to ensure both stability and security. You correctly pointed out that if security were my primary concern, I should have been doing that.
My requirements several years ago made deploying a 5.0 snapshot release very worthwhile. The combination of functionality I desired was too compelling, and likely not to be added to 4.x for some time. Thus, I have balanced functionality, stability, and security by making certain trade offs. Obviously, a breach in security affecting the main cvs tree or cvsup could prove catastrophic.
However, once I decided to live in a relatively unsupported part of the code tree, it has served me well. Since I have a local mirror of the cvs repository, periodically checking out the sources and building via cron is very efficient and requires no labor whatsoever. Many security updates require me to simply ensure that my latest compile went smoothly, cd to an appropriate subdirectory, and run a script to perform a make install to the main system image and once for each jail DESTROOT, then restart service or the system as required.
If such a largely automated ability to upgrade the system or a subsystem was not present, I would have been foolhardy to run a production server so far from a well supported release. In retrospect I am extremely happy to have run so stably and so securely for the past 3 years. I have not had any crashes or unplanned outages during that time (except for a drive failure). I have also to my knowledge (there's always a possibility!) had no security breaches either to the host or to any of its jails.
In my opinion the true measure of security and stability is measured over time, not by a particular point in time. Security is a constantly moving target. If you remain still, you may eventually become vulnerable, or discover that you always were vulnerable, and just did not know it yet. The true beauty of FreeBSD, is that on a stable branch, it is possible with little effort and negligible risk to update your system frequently. Moving gracefully, in small steps as security, stability, and functionality improvements become available.
For a variety of reasons, I have chosen a much less traveled path. My trajectory has not been as graceful. However, my stability, and reasonably high level of security, has been maintained with very little extra effort. This is a testament to the rigor, and high quality of the FreeBSD security and release engineering processes.
I do look forward to rejoining the STABLE fold, soon after 5.3 is released. It will give me more options for rapid response to security, and make more frequent minor upgrades a viable approach again.
One of the nicer things about the FreeBSD Documentation Project is that everything is available both online and offline. All the man pages for every release of FreeBSD (going all the back to 1.0), along with OpenBSD, NetBSD, and several Linux distros, are available at http://www.freebsd.org/cgi/man.cgi
/usr/share/doc, including the Handbook and the Porter's Handbook. If you didn't install the docs during the initial install, they can be fetched (and/or updated) using cvsup. There's a samples docs supfile in /usr/share/examples/cvsup. Just be sure to set DOCS_LANG in /etc/make.conf to the language you want, otherwise you'll get every language availables. :)
:)
And, if you selected the docs distribution during the install, you'll find all the articles, books, and papers under
Having all the documentation available offline is a boon for those days when you break the network.