From 49691e1fb26a770d1ba9eb78c7fea57bd74d9a03 Mon Sep 17 00:00:00 2001 From: bmah Date: Sat, 3 May 2003 22:14:55 +0000 Subject: General update of the Early Adopter's Guide. Too many changes to list here, but they basically fall into two categories: 1) Make the document less 5.0-centric (and more applicable to the state of any 5.X before the RELENG_5 branch) and 2) Update for the current state of 5.X, in anticipation of re-issuing this document as a part of the 5.1 release documentation. --- .../doc/en_US.ISO8859-1/early-adopter/article.sgml | 181 ++++++++++++++------- 1 file changed, 118 insertions(+), 63 deletions(-) diff --git a/release/doc/en_US.ISO8859-1/early-adopter/article.sgml b/release/doc/en_US.ISO8859-1/early-adopter/article.sgml index d70f79c..aa65b2a 100644 --- a/release/doc/en_US.ISO8859-1/early-adopter/article.sgml +++ b/release/doc/en_US.ISO8859-1/early-adopter/article.sgml @@ -16,11 +16,15 @@ %release; + +X"> +X"> + ]>
- Early Adopter's Guide to &os; 5.0-RELEASE + Early Adopter's Guide to &os; &release.current; The &os; Release Engineering Team @@ -34,35 +38,50 @@ The &os; Release Engineering Team + + + This article describes the status of &os; + &release.current;, from the standpoint of users who may be new + to the &release.5x; series of releases or to &os; in general. + It presents some background information on release + engineering, some highlights of new features, and some + possible drawbacks that might be faced by early adopters. It + also contains some of the future release engineering plans for + the 4-STABLE development branch and some tips on upgrading + existing systems. + Introduction - &os; 5.0 marks the first new major version of &os; in + &os; &release.5x; marks the first new major version of &os; in over two years. Besides a number of new features, it also contains a number of major developments in the underlying system architecture. Along with these advances, however, comes a system that incorporates a tremendous amount of new and not-widely-tested code. Compared to the existing line of - 4.X releases, 5.0 may have regressions + &release.4x; releases, the first few &release.5x; releases + may have regressions in areas of stability, performance, and occasionally functionality. - For these reasons, the &a.re; does not - encourage users to blindly update from older &os; releases to - 5.0. Specifically, for more conservative users, we recommend - running 4.X releases (such as + For these reasons, the &a.re; specifically + discourages users from updating from older &os; releases to + &release.current; unless they are aware of (and prepared to deal + with) possible regressions in the newer releases. + Specifically, for more conservative users, we recommend + running &release.4x; releases (such as 4.8-RELEASE) for the near-term future. We feel that such users are probably best served by - upgrading to 5.X only after a + upgrading to &release.5x; only after a 5-STABLE development branch has been created; this may be around - the time of 5.1-RELEASE or 5.2-RELEASE. + the time of 5.2-RELEASE. - (&os; 5.0 suffers from what has been described as a + (&os; &release.5x; suffers from what has been described as a chicken and egg problem. The entire project has - a goal of producing a 5.0-RELEASE that is as stable and reliable + a goal of producing releases that are as stable and reliable as possible. This stability and reliability requires widespread testing, particularly of the system's newer features. However, getting a large number of users to test the system, in a @@ -70,14 +89,14 @@ release first!) This article describes some of the issues involved in - installing and running &os; 5.0-RELEASE. We begin with a + installing and running &os; &release.current;. We begin with a brief overview of the &os; release process. We then present - some of the more noteworthy new features in &os; 5.0, along + some of the more noteworthy new features in &os; &release.current;, along with some areas that may prove troublesome for unwary users. For those users choosing to remain with 4-STABLE-based releases, we give some of the short- to medium-term plans for this development branch. Finally, we present some notes on upgrading - existing 4.X systems to 5.0. + existing &release.4x; systems to &release.current;. @@ -98,12 +117,12 @@ these branches after some amount of testing in CURRENT. At the moment, only one STABLE branch is under active development; this branch is referred to as 4-STABLE, and all of the - &os; 4.X releases were based on + &os; &release.4x; releases were based on it. This branch has the tag RELENG_4 in the CVS repository. - &os; 5.0 will be based on the CURRENT branch. This - will be the first release from this branch in over two years (the + &os; 5.0 and 5.1 are based on the CURRENT branch. These + are the first releases from this branch in over two years (the last was &os; 4.0, in March 2000). At some point after the release of &os; 5.0, a @@ -112,31 +131,37 @@ The past two stable branches (3-STABLE and 4-STABLE) were created immediately after their respective dot-oh releases (3.0 and 4.0, respectively). In hindsight, this - practice did not give sufficient time for either CURRENT or the new - STABLE branches to stabilize after the new branches were - created. + practice did not give sufficient time for either CURRENT + to stabilize before the new branches were + created. This in turn resulted in wasted effort porting bug + fixes between branches, as well as some architectural changes + that could not be ported between branches at all. Therefore, the release engineering team will only create the - 5-STABLE branch in the CVS repository after they have found a + 5-STABLE branch in the CVS repository after we have found a relatively stable state to use as its basis. It is likely that there will be - multiple releases in the 5.X series + multiple releases in the &release.5x; series before this happens; we estimate that the 5-STABLE branch will be created sometime after - 5.1-RELEASE or 5.2-RELEASE. + 5.2-RELEASE. More information on &os; release engineering processes can be found on the Release - Engineering Web pages and in the &os; Release - Engineering article. + Engineering Web pages and in the &os; Release + Engineering article. Specific issues for the upcoming + 5-STABLE development branch can be found in The + Roadmap for 5-STABLE. New Features - A large attraction of &os; 5.0 is a number of new + A large attraction of &os; &release.5x; is a number of new features. These new features and functionality generally involve large architectural changes that were not feasible to port back to the &os; 4-STABLE development branch. (By contrast, many @@ -149,13 +174,15 @@ SMPng: The next generation support for SMP machines (work in progress). There is now partial support for multiple processors to be running in the kernel - at the same time. + at the same time. This work is ongoing. KSE: Kernel Scheduled Entities allow a single process to have multiple kernel-level threads, similar to Scheduler - Activations. + Activations. The (experimental) libkse + and libthr libraries make this + feature available to multi-threaded userland programs. @@ -166,7 +193,7 @@ GCC: The compiler toolchain is now based on GCC - 3.2.1, rather than GCC + 3.2.2, rather than GCC 2.95.X. @@ -190,7 +217,9 @@ UFS2: A new UFS2 on-disk format has been added, which supports extended per-file attributes and larger file - sizes. + sizes. UFS2 is now the default format for &man.newfs.8;. + On all platforms except for pc98, filesystems created from + within &man.sysinstall.8; will use UFS2 by default. @@ -200,14 +229,14 @@ A more comprehensive list of new features can be found in - the release notes for &os; 5.0. + the release notes for &os; &release.prev; and &os; &release.current;. Drawbacks to Early Adoption - Along with the new features of &os; 5.0 come some areas + Along with the new features of &os; &release.5x; come some areas that can cause problems, or at least can lead to unexpected behavior. Generally, these come from the fact that a number of features are works-in-progress. A partial list of these @@ -217,7 +246,9 @@ A number of features are not yet finished. Examples - from the feature list above include SMPng and KSE. + from the feature list above include SMPng and KSE. While + suitable for testing and experimentation, these features may + not be ready for production use. @@ -238,6 +269,14 @@ + Some parts of the &os; base system have fallen into a + state of disrepair due to a lack of users and maintainers. + These have been removed. Specific examples include the + generation of a.out-style executables, XNS networking + support, and the X-10 controller driver. + + + A number of ports and packages do not build or do not run correctly under &os; 5.0, whereas they did under &os; 4-STABLE. Generally these problems are caused by compiler @@ -245,8 +284,7 @@ - Because &os; 5.0 is the first release from the - CURRENT branch in over two years, many of its features are + Many &os; &release.5x; features are seeing wide exposure for the first time. Many of these features (such as SMPng) have broad impacts on the kernel. @@ -264,7 +302,7 @@ branch after a settling time in -CURRENT. &os; 5.0 does not have the stabilizing influence of a -STABLE branch. (It is likely that the 5-STABLE development - branch will be created sometime after 5.1-RELEASE or + branch will be created sometime after 5.2-RELEASE.) @@ -273,7 +311,7 @@ url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/index.html">Handbook and FAQ) - may not reflect changes recently made to &os; 5.0. + may not reflect changes recently made to &os; &release.5x;. @@ -281,7 +319,7 @@ Because a number of these drawbacks affect system stability, the release engineering team recommends that more conservative sites and users stick to releases based on the 4-STABLE branch until - the 5.X series is more polished. + the &release.5x; series is more polished. @@ -289,27 +327,26 @@ Plans for the 4-STABLE Branch The release of &os; 5.0 does not mean the end of the - 4-STABLE branch. There will most likely be at least one more release on + 4-STABLE branch. Indeed, &os; 4.8 was released two months after + 5.0, in April 2003. There will most likely be at least one more release on this branch, namely 4.9-RELEASE, currently scheduled for summer - 2003. - - As of this writing, the release engineering team has no - definite plans for future releases (past 4.8) on the 4-STABLE - branch. However, a 4.9-RELEASE or even a 4.10-RELEASE are - likely possibilities. Any future releases from this branch will + 2003. + A 4.10-RELEASE is a likely possibility as well. + Future releases from this branch will depend on several factors. The most important of these is the existence and stability of the 5-STABLE branch. If CURRENT is not sufficiently stable to allow the creation of a 5-STABLE branch, this may require and permit more releases from the 4-STABLE branch. Until the last declared release - on the 4-STABLE branch, new features may be merged from HEAD at + on the 4-STABLE branch, new features may be merged from HEAD at the discretion of developers, subject to existing release engineering policies. - To some extent, the release engineering team will take into + To some extent, the release engineering team (as well as the + developer community as a whole) will take into account user demand for future 4-STABLE releases. This demand, however, will need to be balanced with release engineering - resources (in terms of personnel, computing resources, and mirror + resources (particularly developers' time, computing resources, and mirror archive space). The &a.security-officer; will continue to support releases @@ -319,20 +356,20 @@ page on the &os; web site. Generally, the two most recent releases from any branch will be supported with respect to security advisories and security fixes. At its discretion, - the team may support other releases. + the team may support other releases for specific issues. - Notes on Upgrading + Notes on Upgrading from &os; &release.4x; For those users with existing &os; systems, this section offers a few notes on upgrading a &os; - 4.X system to - 5.X. As with any &os; upgrade, it + &release.4x; system to + &release.5x;. As with any &os; upgrade, it is crucial to read the release notes and the errata for the version in question, as well as - src/UPDATING for source upgrades. + src/UPDATING in the case of source upgrades. Binary Upgrades @@ -341,14 +378,16 @@ backup everything, reformat, reinstall, and restore everything. This eliminates problems of incompatible or obsolete executables or configuration files polluting the - new system. + new system. It allows new filesystems to be created to take + advantage of new functionality (most notably, the UFS2 + defaults). As of this time, the binary upgrade option in &man.sysinstall.8; has not been well-tested for cross-major-version upgrades. Using this feature is not recommended. In particular, a binary upgrade will leave behind a number of files that are present in &os; - 4.X but not in 5.0. These obsolete + &release.4x; but not in &release.5x;. These obsolete files may create some problems. On the i386 and pc98 platforms, a UserConfig utility @@ -371,7 +410,7 @@ rather than the stripped-down kernel on the floppy images. In theory, any system capable of booting the Microsoft Windows NT 4 installation CDROMs should be able to cope with the &os; - 5.0 CDROMs. + &release.5x; CDROMs. @@ -402,8 +441,8 @@ users will not notice this change. It is generally possible to run old - 4.X executables under - 5.X, but this requires the + &release.4x; executables under + &release.5x;, but this requires the compat4x distribution to be installed. Thus, using old ports may be possible. @@ -417,22 +456,38 @@ (especially with C++ programs) as the compiler may wind up using a mixture of obsolete and current header files. - MAKEDEV is no longer available. - FreeBSD 5.X uses a device filesystem. For more information, + MAKEDEV is no longer available, nor + is it required. + FreeBSD &release.5x; uses a device filesystem, which automatically + creates device nodes on demand. For more information, please see &man.devfs.5;. - + UFS2 is the default on-disk format for file systems + created using &man.newfs.8;. For all platforms except pc98, + it is also the default for file systems created using the disk + labeling screen within &man.sysinstall.8;. Because &os; + &release.4x; only understands UFS1 (not UFS2), disk partitions + that need to be accessed by both &release.5x; and &release.4x; + must be created with UFS1. This can be specified using the + option to &man.newfs.8;, or on the disk + labeling screen in &man.sysinstall.8;. This situation most + often arises with a a single machine that dual-boots &os; + &release.4x; and &os; &release.5x;. Note that there is no way + to convert file systems between the two on-disk formats (other + than backing up, re-creating the file system, and + restoring). + Summary - While &os; 5.0 contains a number of new and exciting + While &os; &release.current; contains a number of new and exciting features, it may not be suitable for all users at this time. In this document, we presented some background on release - engineering, some of the more notable new features of the 5.X + engineering, some of the more notable new features of the &release.5x; series, and some drawbacks to early adoption. We also presented some future plans for the 4-STABLE development branch and some tips on upgrading for early adopters. -- cgit v1.1