cryptsetup - Fix uuid bug, cleanup
[dragonfly.git] / UPDATING
index 3c431d2..ab9cb9f 100644 (file)
--- a/UPDATING
+++ b/UPDATING
@@ -8,38 +8,15 @@
 # If you discover any problem, please contact the bugs@lists.dragonflybsd.org
 # mailing list with the details.
 #
-# $DragonFly: src/UPDATING,v 1.23 2007/05/20 01:07:30 dillon Exp $
+# $DragonFly: src/UPDATING,v 1.26 2008/09/15 20:03:36 thomas Exp $
 
 +-----------------------------------------------------------------------+
 +         UPGRADING DRAGONFLY ON AN EXISTING DRAGONFLY SYSTEM          +
 +                              GENERAL                                 +
 +-----------------------------------------------------------------------+
 
-The best way to upgrade DragonFly is to maintain a copy of the DragonFly
-CVS repository via cvsup and to checkout the source base via this repository.
-The repository is stored in /home/dcvs by default and requires about 800MB
-of disk space.  The checked out source tree (/usr/src) requires about 400MB
-of disk space, and the build will eat around 800MB of space out of /usr/obj.
-To maintain the build you should reserve at least 2.5GB of disk space, and
-3.5GB if you have the space.
-
-Note: most people run cvsup via a root cron job to keep the repository up to
-date.  Please limit such automatic updates to once a day and try to randomize
-the hour and minute in the cron job a bit to avoid pileups.
-
-       # get the CVS repository (it is placed in /home/dcvs)
-       cvsup /usr/share/examples/cvsup/DragonFly-cvs-supfile
-       # install the source from the CVS hierarchy
-       cd /usr
-       cvs -R -d /home/dcvs checkout -P src
-
-Once you have the repository and broken out sources you can decide whether to
-update your sources from the repository automatically or manually.  Since
-you are tracking changes made to DragonFly, it is usually a good idea to
-update the sources manually:
-
-       cd /usr/src
-       cvs update -dP
+Instructions on how to obtain and maintain DragonFly source code using git
+are in the development(7) manual page.
 
 To upgrade a DragonFly system from sources you run the following sequence:
 
@@ -55,15 +32,38 @@ older DragonFly installations and should delete them automatically.
 
        make upgrade
 
-NOTE! Never do a 'make upgrade' before 'make installworld' has been run.
-Doing so might leave your system in an unusable state.
+See the build(7) manual page for further information.
 
 Once you've done a full build of the world and kernel you can do incremental
 upgrades of either by using the 'quickworld' and 'quickkernel' targets
 instead of 'buildworld' and 'buildkernel'.  If you have any problems with
-the quick targets, try doing a cvsup, cvs update, and then a full buildworld
+the quick targets, try updating your repo first, and then a full buildworld
 and buildkernel as shown above, before asking for help.
 
++-----------------------------------------------------------------------+
++         UPGRADING FROM DRAGONFLY <= 2.0 TO DRAGONFLY >= 2.1          +
++-----------------------------------------------------------------------+
+
+In 2.1 kernel and modules has moved to boot directory.  For most cases
+this is handled automatically by 'make upgrade'.  A few cases needs manual
+intervention:
+
+ * When installing a kernel without first doing a make buildworld,
+   installworld and upgrade to the same DESTDIR as kernel:
+   make DESTDIR/boot directory and move kernel and modules into this boot
+   directory; also move kernel.old and modules.old.
+   Typical example is vkernel(7), use (no modules used):
+
+       cd /var/vkernel
+       mkdir boot
+       chflags noschg kernel
+       mv kernel kernel.old boot
+       chflags schg boot/kernel
+       
+ * When using a boot-only partition, /boot/loader.rc needs to be edited:
+   delete occurrences of '/boot/'.
+   These occurences can normally be deleted in any case, see loader(8).
+
 +-----------------------------------------------------------------------+
 +         UPGRADING FROM DRAGONFLY <= 1.8 TO DRAGONFLY >= 1.9          +
 +-----------------------------------------------------------------------+
@@ -71,7 +71,8 @@ and buildkernel as shown above, before asking for help.
 In 1.9 major changes to the disk management infrastructure have taken
 place.  make upgrade may not catch all of your disk devices in /dev,
 so after upgrading be sure to cd /dev; ./MAKEDEV <blah> where <blah>
-are all of your disk devices.
+are all of your disk devices.  HOWEVER, from late 2.3 on we run devfs
+and MAKEDEV no longer exists.
 
 The biggest changes in 1.9 are:
 
@@ -156,7 +157,6 @@ add any that are missing:
 
 smmsp:*:25:25::0:0:Sendmail Submission User:/var/spool/clientmqueue:/sbin/nologin
 _pflogd:*:64:64::0:0:pflogd privsep user:/var/empty:/sbin/nologin
-_ntp:*:65:65::0:0:ntpd privsep user:/var/empty:/sbin/nologin
 
 The following groups may be missing from your group file.  Use vi /etc/group
 and add any that are missing:
@@ -164,7 +164,6 @@ and add any that are missing:
 smmsp:*:25:
 authpf:*:63:
 _pflogd:*:64:
-_ntp:*:65:
 
 
 > Upgrading to DragonFly from FreeBSD