UPDATING

   1 # Updating Information for DragonFly users.
   2 #
   3 #
   4 # This file should warn you of any pitfalls which you might need to work around
   5 # when trying to update your DragonFly system.  The information below is
   6 # in reverse-time order, with the latest information at the top.
   7 #
   8 # If you discover any problem, please contact the bugs@lists.dragonflybsd.org
   9 # mailing list with the details.
  10
  11 +-----------------------------------------------------------------------+
  12 +         UPGRADING DRAGONFLY FROM 4.6 TO LATER VERSIONS                +
  13 +-----------------------------------------------------------------------+
  14
  15 OPENSSL REMOVED
  16 ---------------
  17
  18 OpenSSL has been removed from base and replaced with a private version of
  19 LibreSSL.  The previously installed OpenSSL libraries, headers, and man
  20 pages will remain on the system unless the "make upgrade" command is
  21 specifically instructed to remove them.  To do this, define
  22 REMOVE_OPENSSL_FILES for the upgrade command, e.g.
  23 "make upgrade REMOVE_OPENSSL_FILES=yes"
  24
  25 It is recommended that the OpenSSL files be removed to avoid configuration
  26 scripts from using the stale and potentially vulnerable version, but all
  27 binaries that are dynamically linked to the OpenSSL libraries should be
  28 rebuilt first to avoid breakage.
  29
  30 16 Oct 2016: The OpenSSL sources and makefiles haven't been removed yet.
  31 They can still be built by putting "FORCE_OPENSSL=yes" in make.conf.
  32 This feature will likely be removed within a month, and definitely
  33 before the release of DF 4.8.
  34
  35 CS, EX AND VX DRIVERS REMOVED
  36 -----------------------------
  37
  38 The cs(4), ex(4) and vx(4) drivers have been removed. They were very
  39 old and its doubtful they ever worked properly in x86_64 but they were
  40 in X86_64_GENERIC, so custom configurations derived from it have to be
  41 adjusted.
  42
  43 +-----------------------------------------------------------------------+
  44 +         UPGRADING DRAGONFLY FROM 4.4 TO LATER VERSIONS                +
  45 +-----------------------------------------------------------------------+
  46
  47 AMD REMOVED
  48 -----------
  49
  50 The am-utils automounter suite has been removed. It stopped working
  51 at some point and was never fixed. autofs(5) and the associated
  52 userland has been brought in from FreeBSD and replaces it.
  53
  54 AN DRIVER REMOVED
  55 -----------------
  56
  57 The an(4) driver has been removed. It was in the X86_64_GENERIC kernel
  58 config file, so any configurations derived from it have to be adjusted.
  59
  60 /DEV/DRI GROUP CHANGED
  61 ----------------------
  62
  63 The default group assigned to /dev/dri entries has been changed
  64 from 'wheel' to 'video' with the id of '44'. If you want to have
  65 access to the dri devices please add yourself to the video group
  66 with:
  67
  68 # pw groupmod video -m $USER
  69
  70 +-----------------------------------------------------------------------+
  71 +         UPGRADING DRAGONFLY FROM 4.2 TO LATER VERSIONS                +
  72 +-----------------------------------------------------------------------+
  73
  74 DSCHED REMOVED
  75 --------------
  76
  77 dsched(4) has been removed and one of its kernel options, DSCHED_FQ, was
  78 in our default kernel config file. So the DSCHED_FQ option has been turned
  79 into a no-op for now and can be removed from custom configurations.
  80
  81 EST DRIVER REMOVED, COMPILE_ET AND LIBCOM_ERR TOO
  82 -------------------------------------------------
  83
  84 The est(4) driver has been removed. All CPUs it supported (except one)
  85 were 32 bits only. Those who are still using the Core 2 Duo T7500 should
  86 report back if there are any issues with this CPU and our regular ACPI
  87 P-state support.
  88
  89 Also, compile_et(1) and com_err(3) have been removed as well. They
  90 should have been removed along with kerberos support, back in 2009.
  91
  92 SEVERAL LOCALES RENAMED
  93 -----------------------
  94
  95 Several locales were using obsolete and misleading names, and thus have
  96 been adjusted to current standards. Any users of the following locales
  97 need to select alternates:
  98
  99 DFLY 4.2 locale            DFLY 4.4 alterative locale
 100 ---------------            ------------------------------------
 101 mn_MN.UTF-8                mn_Cyrl_MN.UTF-8
 102 no_NO.UTF-8                nb_NO.UTF-8      or nn_NO.UTF-8
 103 no_NO.ISO8859-1            nb_NO.ISO8869-1  or nn_NO.ISO8859-1
 104 no_NO.ISO8859-15           nb_NO.ISO8859-15 or nn_NO.ISO8859-15
 105 sr_YU.UTF-8                sr_Cyrl_RS.UTF-8 or sr_Latn_RS.UTF-8
 106 sr_YU.ISO8859-5            sr_Cyrl_RS.ISO8859-5
 107 sr_YU.ISO8859-2            sr_Latn_RS.ISO8859-2
 108 zh_CN.GBK                  zh_Hans_CN.GBK
 109 zh_CN.UTF-8                zh_Hans_CN.UTF-8
 110 zh_CN.eucCN                zh_Hans_CN.eucCN
 111 zh_CN.GB2312               zh_Hans_CH.GB2312
 112 zh_CN.GB18030              zh_Hans_CH.GB18030
 113 zh_HK.Big5HKSCS            zh_Hant_HK.Big5HKSCS
 114 zh_HK.UTF_8                zh_Hant_HK.UTF-8
 115 zh_TW.Big5                 zh_Hant_TW.Big5
 116 zh_TW.UTF-8                zh_Hant_TW.UTF-8
 117
 118 +-----------------------------------------------------------------------+
 119 +         UPGRADING DRAGONFLY FROM 4.0 TO LATER VERSIONS                +
 120 +-----------------------------------------------------------------------+
 121
 122 BINUTILS 2.25 REPLACES 2.22, PRIMARY
 123 ------------------------------------
 124
 125 The oldest of the two versions of Binutils, version 2.22, was removed
 126 and replaced with Binutils 2.25.  It becomes the primary version version
 127 of binutils and version 2.24 becomes the alternate.  There are 8 current
 128 CVE written against 2.24, so for security reasons version 2.25 should
 129 always be used.
 130
 131 The accepted values of BINUTILSVER are now "binutils225" (default) and
 132 "binutils224".  The building of Binutils 2.24 can be prevented by setting
 133 NO_ALTBINUTILS=yes in make.conf.
 134
 135 LOADER OPTIONS CHANGED
 136 ----------------------
 137
 138 Right after the development branch started, the Fred art accompanying the
 139 loader menu was improved.  The line between Fred and the menu was removed
 140 by default (but can optionally be returned) and the placement shifted as
 141 a result.  The drawing was improved, and the colored version was improved,
 142 changing the eyes and wing color from white to red.  A new color version
 143 of Fred was added, one with a blue scheme.
 144
 145 The loader menu defaults have changed since release 4.0:  The vertical
 146 line was removed, the loader is displayed in color by default*, and the
 147 blue scheme is used.
 148
 149 The loader.conf changes are:
 150 loader_color:   option has been removed
 151 loader_plain:   option has been added, it changed menu to monochrome
 152 fred_is_red:    changes color scheme from blue to red
 153 fred_is_blue:   option existed only on 4.1, it has been removed
 154 fred_separated: Adds line between Fred and menu (as seen previously)
 155
 156 * If loader.conf defines "console" as "comconsole" or "console" is defined
 157   in the environment as "comconsole" then color will not be displayed,
 158   even if loader_plain value is "NO".
 159
 160 SENDMAIL REMOVED FROM BASE
 161 --------------------------
 162
 163 The only Mail Transfer Agent provided now is DragonFly Mail Agent (dma).
 164 If the system being upgraded is still configured to use the sendmail
 165 binaries from base, the "make upgrade" command will fail.
 166
 167 The administrator must change /etc/mail/mailer.conf to switch the
 168 mailwrapper to dma or a DPorts-based MTA prior to running the upgrade
 169 command that permanently removes sendmail executables and could
 170 potentially break a running mail server.
 171
 172 Refer: http://www.dragonflybsd.com/docs/docs/newhandbook/mta/ for
 173 detailed instructions on how to configure the MTA selection.
 174
 175 _KPOSIX_VERSION and P1003_1B OPTIONS REMOVED
 176 --------------------------------------------
 177
 178 The _KPOSIX_VERSION and P1003_1B kernel options have been changed to
 179 no-ops. They can be removed from custom kernel configurations.
 180
 181 SOUND SYSTEM UPDATED FROM FreeBSD 11-CURRENT
 182 --------------------------------------------
 183
 184 Many more sound devices may be detected.
 185
 186 If the default device choosen isn't to your liking, setting the sysctl
 187 hw.snd.default_unit to a different number will change it.
 188
 189 SCTP SUPPORT DROPPED
 190 --------------------
 191
 192 Support for the SCTP protocol has been removed.
 193
 194 OLD USB DRIVERS REMOVED
 195 -----------------------
 196
 197 The old USB stack, along with the kernel config option "device oldusb"
 198 and the make.conf variable "WANT_OLDUSB" have been removed. This means
 199 that for custom kernel configuration files which were derived from a
 200 GENERIC or X86_64_GENERIC file prior to making the usb4bsd stack default,
 201 various (old USB stack specific) devices will now complain about being
 202 unknown:
 203
 204   * oldusb      (obviously)
 205   * natausb     (not yet ported to usb4bsd)
 206   * rue         (not yet ported to usb4bsd)
 207   * ugen        (no longer needed in usb4bsd)
 208   * urio        (not yet ported to usb4bsd)
 209   * uscanner    (no longer needed in usb4bsd)
 210
 211 They should be removed or commented out in such custom kernel configs.
 212
 213 GCC 5
 214 -----
 215
 216 The GCC 4.4 compiler has been retired.  It has been replaced by a GCC 5.1.
 217 The following make.conf variables no longer work: NO_GCC44, NO_OBJC, and
 218 NO_CXX.  The latter was never documented and the latest versions of GCC are
 219 partially written in C++ so a C++ compiler is no longer optional.  In
 220 practical terms it has not been optional for many years as other base
 221 components are also written in C++.  The resource savings by avoiding
 222 building Objective-C compiler is so small, the complexity added by NO_OBJC
 223 internally was deemed a bad tradeoff so that is the reason for its removal.
 224 Also note that no "info" pages are installed with GCC 5.  After this entry
 225 was originally written, all info pages were removed from DragonFly.
 226
 227 GCC 5.1 has been designated as the primary compiler.  As such, there is a
 228 new make.conf variable, NO_ALTCOMPILER.  It will block the rebuilding of
 229 the designated secondary compiler, GCC 4.7.  However, while DPorts
 230 primarily uses GCC 5 to build ports now, it still uses GCC 4.7 as well, so
 231 if building ports from source is desired, don't block building of the
 232 secondary compiler.
 233
 234 +-----------------------------------------------------------------------+
 235 +         UPGRADING DRAGONFLY FROM 3.8 TO LATER VERSIONS                +
 236 +-----------------------------------------------------------------------+
 237
 238 SMP AND DEVICE_POLLING OPTIONS MADE UNKNOWN
 239 -------------------------------------------
 240
 241 DEVICE_POLLING was replaced by IFPOLL_ENABLE and the former SMP code is
 242 the default now (even on single-core systems), both for, like, 21 months.
 243 We kept the options around as no-ops as a convenience, to allow people
 244 using the same config for the then current release and the then current
 245 master. That period is now over, so any configs still having those
 246 options have to be adjusted.
 247
 248 SYSVIPC SYSCALLS MADE NON-OPTIONAL
 249 ----------------------------------
 250
 251 The code related to the SYSVMSG, SYSVSEM and SYSVSHM kernel options is
 252 now compiled in by default. The options are no-ops for now.
 253
 254 DEFAULT DRIVER CHANGED FOR LSI "THUNDERBOLT" SERIES RAID CONTROLLERS
 255 --------------------------------------------------------------------
 256
 257 The default driver for those controllers is now mrsas(4) due to reports
 258 of file system corruption using the mfi(4) driver. The whole issue (and
 259 how to deal with potential problems when switching) was explained here:
 260
 261 http://lists.dragonflybsd.org/pipermail/users/2014-July/128703.html
 262
 263 A tunable is provided for letting those controllers still attach via
 264 the mfi(4) driver, hw.mrsas.mfi_enable (see mrsas(4) manual page).
 265
 266 OLDER NETWORK DRIVERS MOVED TO I386 ONLY
 267 ----------------------------------------
 268
 269 The following drivers have been made i386 only: ed(4), sr(4), ng_sync_ar
 270 and ng_sync_sr. ed(4) used to be in X86_64_GENERIC, so it has to be
 271 removed in kernel configs derived from X86_64_GENERIC.
 272
 273 +-----------------------------------------------------------------------+
 274 +         UPGRADING DRAGONFLY FROM 3.6 TO LATER VERSIONS                +
 275 +-----------------------------------------------------------------------+
 276
 277 UPDATE FROM MOST RECENT 3.6
 278 ---------------------------
 279
 280 Versions of 3.6 built before June 25th have a bug where installworld might
 281 crash during installation of the new initrd.  Upgrade to the latest version
 282 of 3.6 before updating to 3.8 or later.
 283
 284 ATM, IPX, NCP AND NWFS SUPPORT DROPPED
 285 --------------------------------------
 286
 287 Support for the IPX and NCP network protocols and for mouting NetWare
 288 file systems has been dropped. Dito for ATM protocol support.
 289
 290 INITRD IMAGES NOW INSTALLED BY DEFAULT
 291 --------------------------------------
 292
 293 An initial ramdisk image is now installed in /boot/kernel/initrd.img.gz
 294
 295 Older images installed under the file name of initrd.img will be removed
 296 automatically by the make upgrade process.
 297
 298 USB4BSD IS NOW THE DEFAULT USB STACK
 299 ------------------------------------
 300
 301 To get back to the old stack, put "WANT_OLDUSB=yes" in /etc/make.conf and
 302 replace "device usb" with "device oldusb" in the kernel configuration.
 303
 304 MORE ISA SUPPORT DROPPED
 305 ------------------------
 306
 307 ISA support has been dropped from the following drivers: adv(4), an(4),
 308 ar(4), cs(4), digi(4), ed(4), ep(4), ex(4), fe(4), lnc(4), sbni(4),
 309 si(4), sn(4), and stg(4).
 310
 311 +-----------------------------------------------------------------------+
 312 +         UPGRADING DRAGONFLY FROM 3.4 TO LATER VERSIONS                +
 313 +-----------------------------------------------------------------------+
 314
 315 ABI CHANGE
 316 ----------
 317
 318 Installed third-party software (dports) will have to be rebuilt after upgrade,
 319 or reinstalled from binary packages.
 320
 321 UPDATING FROM 3.4 TO 3.6
 322 ------------------------
 323
 324 This only applies for this specific upgrade due to locale changes; it is
 325 not needed for upgrades after 3.6.  Please update in this order:
 326
 327 make buildworld
 328 make buildkernel
 329 make installworld
 330 make installkernel
 331 *reboot*
 332 make upgrade
 333
 334 See this mailing list post for details:
 335 http://lists.dragonflybsd.org/pipermail/users/2013-September/090163.html
 336
 337 CYRIX OPTIONS REMOVED
 338 ---------------------
 339
 340 The following Cyrix related options have been removed: CPU_BTB_EN,
 341 CPU_CYRIX_NO_LOCK, CPU_DIRECT_MAPPED_CACHE, CPU_DISABLE_5X86_LSSER,
 342 CPU_FASTER_5X86_FPU, CPU_IORT, CPU_LOOP_EN, CPU_RSTK_EN, CPU_SUSP_HLT,
 343 CYRIX_CACHE_WORKS, and CYRIX_CACHE_REALLY_WORKS
 344
 345 ISA SUPPORT REMOVED FROM RP(4)
 346 ------------------------------
 347
 348 ISA support has been removed from the rp(4) driver. It is now PCI only.
 349
 350 +-----------------------------------------------------------------------+
 351 +         UPGRADING DRAGONFLY FROM 3.2 TO LATER VERSIONS                +
 352 +-----------------------------------------------------------------------+
 353
 354 COMPAT_SUNOS OPTION REMOVED
 355 ---------------------------
 356
 357 The COMPAT_SUNOS option has been removed. It was meant to provide binary
 358 compatibility with SunOS 4.x for the sparc32 port of 4.4BSD.
 359
 360 ISA SOUND CARD SUPPORT REMOVED
 361 ------------------------------
 362
 363 The following modules have been removed (all for ISA sound cards):
 364 snd_ad1816.ko, snd_ess.ko, snd_mss.ko, snd_sb8.ko, snd_sb16.ko, snd_sbc.ko
 365
 366 GCC 4.7
 367 -------
 368
 369 DragonFly has switched base compilers.  GCC 4.7 is now the default
 370 compiler and GCC 4.4 is the alternative compiler.  The "NO_GCC47" make
 371 variable ceases to work now.
 372
 373 Users who wish to build only GCC 4.7 have to use NO_GCC44 in the
 374 /etc/make.conf to prohibit GCC 4.4 from building.  However, using it is
 375 highly discouraged.  There are a few packages in pkgsrc that do not build
 376 with GCC 4.7 and the new "DPorts" system uses GCC 4.4 by default.  At
 377 this time, it is recommended to keep both compilers on the base system.
 378
 379 SMP OPTION REMOVED
 380 ------------------
 381
 382 The SMP kernel option has been made a no-op. All kernels now feature SMP
 383 support. If you have 'options SMP' in your kernel config, you can as well
 384 remove it.
 385
 386 DEVICE_POLLING OPTION REPLACED BY IFPOLL_ENABLE OPTION, KTR_POLLING REMOVED
 387 ---------------------------------------------------------------------------
 388
 389 The DEVICE_POLLING kernel option has been made a no-op and it has been
 390 replaced by IFPOLL_ENABLE.  If you have 'options DEVICE_POLLING' in your
 391 kernel config, you need to change it to IFPOLL_ENABLE.
 392
 393 Also, the KTR_POLLING kernel option has been removed, so it must be
 394 removed from kernel configs that have it.
 395
 396 BUSLOGIC, CYCLADES AND STALLION ISA SUPPORT REMOVED
 397 ---------------------------------------------------
 398
 399 The bt(4) driver for Buslogic SCSI adapters has been made PCI only. ISA
 400 cards will no longer be detected.
 401
 402 The same has been done for Stallion multiport serial controllers. stli(4)
 403 has been completely removed (along with the stlload(8) and stlstty(8)
 404 utilities) and stl(4) was changed to support only PCI cards. Similarly,
 405 ISA support was removed from cy(4) too. All these drivers are i386 only.
 406
 407 COMPAT_OLDISA OPTION GONE
 408 -------------------------
 409
 410 The i386 specific COMPAT_OLDISA kernel option has been removed, since
 411 nothing needs it anymore.
 412
 413 +-----------------------------------------------------------------------+
 414 +         UPGRADING DRAGONFLY FROM 3.0 TO LATER VERSIONS                +
 415 +-----------------------------------------------------------------------+
 416
 417 APIC_IO OPTION REMOVED
 418 ----------------------
 419
 420 The APIC_IO kernel option is no longer accepted after having been without
 421 effect for a while. The hw.ioapic_enable tunable now serves its purpose.
 422 If you have 'options APIC_IO' in your kernel config, you'll have to
 423 remove it.
 424
 425 WATCHDOG_ENABLE & HW_WDOG OPTIONS REMOVED
 426 -----------------------------------------
 427
 428 The wdog framework is now compiled into our kernels by default, so the
 429 options are no longer needed.
 430
 431 DOSCMD(1) REMOVED
 432 -----------------
 433
 434 doscmd(1) has been removed. It was i386 only. The doscmd(1) specific
 435 NO_X make.conf option was removed too.
 436
 437 GCC 4.7
 438 -------
 439
 440 GCC 4.7 has been brought in and replaces GCC 4.1 as DragonFly's non-
 441 default compiler in base (default is still GCC 4.4).
 442
 443 Users who wish to build only GCC 4.4 have to replace NO_GCC41 with
 444 NO_GCC47 in /etc/make.conf.
 445
 446 USB4BSD
 447 -------
 448
 449 A new USB stack (from FreeBSD) has been brought in. The following
 450 modules have been ported so far: usb, uhci, ohci, ehci, xhci, umass,
 451 usfs, uether, if_axe, if_udav, ukbd, ums, uep, uhid, usb_quirk,
 452 and uaudio.
 453
 454 It is not yet the default. To activate it, WANT_USB4BSD=yes has to
 455 be put in make.conf and device "usb4bsd" (quotes needed) has to
 456 replace device usb in the kernel config. After that, a full
 457 build/install/upgrade cycle is needed.
 458
 459 Note that this is experimental and incomplete, but we are interested
 460 in hearing about issues with it, of course.
 461
 462 ISA SUPPORT REMOVED FROM AIC-6260/6360 DRIVER
 463 ---------------------------------------------
 464
 465 ISA adapter support was dropped from the aic(4) driver.
 466
 467 +-----------------------------------------------------------------------+
 468 +         UPGRADING DRAGONFLY FROM 2.10 TO LATER VERSIONS               +
 469 +-----------------------------------------------------------------------+
 470
 471 SEVERAL ISA DRIVERS REMOVED
 472 ---------------------------
 473
 474 The following ISA only drivers have been removed along with a couple of
 475 associated userland tools:
 476
 477 aha(4)
 478 asc(4) & sasc(1)
 479 ctx
 480 dgb(4)
 481 el(4)
 482 gpib
 483 gsc(4) & sgsc(1)
 484 ie(4)
 485 labpc(4)
 486 le(4)
 487 mse(4)
 488 rc(4)
 489 rdp(4)
 490 spigot
 491 tw(4) & xten(1) & xtend(8)
 492 wl(4) & wlconfig(8)
 493 wt(4)
 494
 495 Note that two of these drivers (aha(4) and ie(4)) are in our GENERIC
 496 config and one (aha(4)) is in our X86_64_GENERIC kernel configuration
 497 file.
 498
 499 If buildkernel complains about any of these drivers, just remove them
 500 from your kernel configuration.
 501
 502 BINUTILS 2.20
 503 -------------
 504 Binutils 2.20 has been removed in favor of Binutils 2.22.  The accepted
 505 values of BINUTILSVERS are now binutils221 and binutils222 (default).
 506
 507 BUILDWORLD/-KERNEL PARALLELIZATION WORK
 508 ---------------------------------------
 509 Due to changes in the way we build with more than one make job, you
 510 will have to update install(1) and mkdir(1) prior to buildworld if you
 511 want to build with 'make -j':
 512
 513 cd /usr/src/usr.bin/xinstall; make; make install; make clean
 514 cd /usr/src/bin/mkdir; make; make install; make clean
 515
 516 DMA(8) UPGRADE
 517 --------------
 518 dma(8) has been upgraded to v0.7 which no longer supports the
 519 /etc/dma/virtusertable. Some of its functionality has been replaced
 520 with the MASQUERADE keyword and the EMAIL environment variable (see
 521 the dma(8) manual page).
 522
 523 +-----------------------------------------------------------------------+
 524 +         UPGRADING DRAGONFLY FROM 2.8 TO LATER VERSIONS                +
 525 +-----------------------------------------------------------------------+
 526
 527 GCC 4.4 & BINUTILS 2.21
 528 -----------------------
 529
 530 GCC 4.4 has been made DragonFly's default compiler and Binutils 2.21 has
 531 been made DragonFly's default Binutils.
 532
 533 That means that any settings that set CCVER to 'gcc44' are not needed
 534 anymore. Instead, CCVER can be set to 'gcc41' to go back to using
 535 GCC 4.1.
 536
 537 It also means that 'binutils221' as a value for BINUTILSVER has no
 538 effect anymore. 2.17 has been removed and 'binutils220' is available
 539 as an option.
 540
 541 The NO_GCC44 option has been removed and will not affect the build
 542 anymore. There is now a NO_GCC41 option that will prevent GCC 4.1 from
 543 building in a similar fashion.
 544
 545 Note that you must do a full buildworld/buildkernel for upgrading.
 546
 547 pkg_radd settings
 548 -----------------
 549
 550 The config file for pkg_radd has moved from /etc/settings.conf to
 551 /etc/pkg_radd.conf.  Save the contents of settings.conf before upgrading
 552 if this is needed.  This warning only applies if /etc/settings.conf
 553 exists.  pkg_radd will continue to work with defaults.
 554
 555 +-----------------------------------------------------------------------+
 556 +         20100927                                                      +
 557 +         UPGRADING DRAGONFLY FROM 2.6 to 2.8 or HEAD                   +
 558 +-----------------------------------------------------------------------+
 559
 560 OpenSSL
 561 --------
 562
 563 OpenSSL has been upgraded, and SHLIB_MAJOR was bumped for libssh and libcrypto.
 564 This shouldn't break any 3rd-party software, but you'll need to recompile your
 565 3rd-party software if you want it to link against the new version of OpenSSL.
 566
 567 Loader
 568 -------
 569
 570 A new loader (dloader) has been added which better handles booting from
 571 multiple kernel/module versions.
 572
 573 To upgrade (Only for this upgrade, for post 2.8 upgrades see GENERAL below)
 574
 575         cd /usr/src
 576         make buildworld
 577         make installworld
 578         make upgrade
 579         make buildkernel KERNCONF=<KERNELNAME>
 580         make installkernel KERNCONF=<KERNELNAME>
 581
 582 Note that you must installworld and run the 'upgrade' target before
 583 installing the new kernel.
 584
 585 BIND
 586 -----
 587
 588 BIND has been removed from the base system.  The ldns and drill tools have
 589 been added for basic functionality.  Use 'drill' where you would normally
 590 use nslookup or dig, or install BIND from pkgsrc.  It's available as
 591 net/bind95, net/bind96, or net/bind97 as of this writing.
 592
 593 This only affects older systems upgrading to 2.8.  New 2.8+ installs
 594 include BIND as a pkgsrc package.
 595
 596 +-----------------------------------------------------------------------+
 597 +         UPGRADING DRAGONFLY ON AN EXISTING DRAGONFLY SYSTEM           +
 598 +                               GENERAL                                 +
 599 +-----------------------------------------------------------------------+
 600
 601 Instructions on how to obtain and maintain DragonFly source code using git
 602 are in the development(7) manual page.
 603
 604 To upgrade a DragonFly system from sources you run the following sequence:
 605
 606         cd /usr/src
 607         make buildworld
 608         make buildkernel KERNCONF=<KERNELNAME>
 609         make installkernel KERNCONF=<KERNELNAME>
 610         make installworld
 611
 612 You will also want to run the 'upgrade' target to upgrade your /etc and the
 613 rest of your system.  The upgrade target is aware of stale files created by
 614 older DragonFly installations and should delete them automatically.
 615
 616         make upgrade
 617
 618 See the build(7) manual page for further information.
 619
 620 Once you've done a full build of the world and kernel you can do incremental
 621 upgrades of either by using the 'quickworld' and 'quickkernel' targets
 622 instead of 'buildworld' and 'buildkernel'.  If you have any problems with
 623 the quick targets, try updating your repo first, and then a full buildworld
 624 and buildkernel as shown above, before asking for help.
 625
 626 +-----------------------------------------------------------------------+
 627 +         UPGRADING FROM DRAGONFLY <= 2.0 TO DRAGONFLY >= 2.1           +
 628 +-----------------------------------------------------------------------+
 629
 630 In 2.1 kernel and modules has moved to boot directory.  For most cases
 631 this is handled automatically by 'make upgrade'.  A few cases needs manual
 632 intervention:
 633
 634  * When installing a kernel without first doing a make buildworld,
 635    installworld and upgrade to the same DESTDIR as kernel:
 636    make DESTDIR/boot directory and move kernel and modules into this boot
 637    directory; also move kernel.old and modules.old.
 638    Typical example is vkernel(7), use (no modules used):
 639
 640         cd /var/vkernel
 641         mkdir boot
 642         chflags noschg kernel
 643         mv kernel kernel.old boot
 644         chflags schg boot/kernel
 645
 646  * When using a boot-only partition, /boot/loader.rc needs to be edited:
 647    delete occurrences of '/boot/'.
 648    These occurences can normally be deleted in any case, see loader(8).
 649
 650 +-----------------------------------------------------------------------+
 651 +         UPGRADING FROM DRAGONFLY <= 1.8 TO DRAGONFLY >= 1.9           +
 652 +-----------------------------------------------------------------------+
 653
 654 In 1.9 major changes to the disk management infrastructure have taken
 655 place.  make upgrade may not catch all of your disk devices in /dev,
 656 so after upgrading be sure to cd /dev; ./MAKEDEV <blah> where <blah>
 657 are all of your disk devices.  HOWEVER, from late 2.3 on we run devfs
 658 and MAKEDEV no longer exists.
 659
 660 The biggest changes in 1.9 are:
 661
 662 (1) That whole-slice devices such as da0s1 no longer share the same device
 663     id as partition c devices such as da0s1c.
 664
 665 (2) The whole-disk device (e.g. da0) is full raw access to the disk,
 666     with no snooping or reserved sectors.  Consequently you cannot run
 667     disklabel on this device.  Instead you must run disklabel on a
 668     whole-slice device.
 669
 670 (3) The 'compatibility' partitions now use slice 0 in the device name,
 671     so instead of da0a you must specify da0s0a.  Also, as per (1) above,
 672     accessing the disklabel for the compatibility partitions must be
 673     done via slice 0 (da0s0).
 674
 675 (4) Many device drivers that used to fake up labels, such as CD, ACD, VN,
 676     and CCD now run through the disk management layer and are assigned
 677     real disk management devices.   VN and CCD in particular do not usually
 678     use a MBR and disklabels must be accessed through the compatibility
 679     slice 0.  Your /etc/ccd.conf file still specifies 'ccd0', though, you
 680     don't name it 'ccd0s0' in the config file.
 681
 682 Generally speaking, you have to get used to running fdisk and disklabel on
 683 the correctly specified device names.  A lot of the wiggle, such as running
 684 disklabel on a partition, has been removed.
 685
 686 +-----------------------------------------------------------------------+
 687 +         UPGRADING FROM OLDER VERSIONS OF DRAGONFLY OR FREEBSD         +
 688 +-----------------------------------------------------------------------+
 689
 690 > Kerberos IV
 691 -------------
 692
 693 Kerberos IV (eBones) was removed from the tree, please consider moving to
 694 Kerberos 5 (Heimdal).
 695
 696 > Package Management System
 697 ---------------------------
 698
 699 Starting with the 1.4 release, DragonFly uses NetBSD's pkgsrc package
 700 management system.  The necessary tools to build and maintain packages
 701 are provided in /usr/pkg/bin and /usr/pkg/sbin.  Make sure that these
 702 directories are in your PATH variable.
 703
 704 In order to obtain a reasonably current snapshot of the pkgsrc tree, use
 705 the tarball from NetBSD:
 706
 707         fetch -o /tmp/pkgsrc.tar.gz ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc.tar.gz
 708         cd /usr; tar -xzf /tmp/pkgsrc.tar.gz; chown -R root:wheel pkgsrc
 709
 710 This tree can then be kept up to date with cvs update:
 711
 712         cd /usr/pkgsrc; cvs up
 713
 714 NOTE! If you upgraded from a pre-1.4 system to 1.4 or later, you need to
 715 build and install the pkgsrc bootstrap manually:
 716
 717         cd /usr/pkgsrc/bootstrap
 718         ./bootstrap --pkgdbdir /var/db/pkg --prefix /usr/pkg
 719
 720 +-----------------------------------------------------------------------+
 721 +         UPGRADING DRAGONFLY ON AN EXISTING DRAGONFLY SYSTEM           +
 722 +         UPDATING FROM PRE-1.2 SYSTEMS OR FreeBSD 4.x TO               +
 723 +         DRAGONFLY 1.3+ (EITHER PREVIEW or HEAD)                       +
 724 +-----------------------------------------------------------------------+
 725
 726 The compatibility shims for the build environment have been removed, you
 727 have to update to DragonFly 1.2 release branch first.
 728
 729 The default PAM configuration has moved from /etc/pam.conf to /etc/pam.d/.
 730 The existing configuration can be converted using /etc/pam.d/convert.sh.
 731 Entries in /etc/pam.d/ override entries in /etc/pam.conf. In addition
 732 the pam_skey.so module was retired, you have to remove it manually from
 733 your configuration, when you convert it.
 734
 735 > Required user and group IDs when upgrading from either FreeBSD or DragonFly
 736 ---------------------
 737
 738 The following users may be missing from your password file.  Use vipw and
 739 add any that are missing:
 740
 741 smmsp:*:25:25::0:0:Sendmail Submission User:/var/spool/clientmqueue:/sbin/nologin
 742 _pflogd:*:64:64::0:0:pflogd privsep user:/var/empty:/sbin/nologin
 743
 744 The following groups may be missing from your group file.  Use vi /etc/group
 745 and add any that are missing:
 746
 747 smmsp:*:25:
 748 authpf:*:63:
 749 _pflogd:*:64:
 750
 751
 752 > Upgrading to DragonFly from FreeBSD
 753 ---------------------
 754
 755 You can build the DragonFly world and DragonFly kernels on a FreeBSD-4.x or
 756 FreeBSD-5.x machine and then install DragonFly over FreeBSD, replacing
 757 FreeBSD.  Note that the DragonFly buildworld target does not try to reuse
 758 make depend information, it starts from scratch, so no pre-cleaning of the
 759 object hierarchy is necessary.
 760
 761         # get the CVS repository (it is placed in /home/dcvs, 500MB).
 762         # Please use the -h option and a mirror site to pull the
 763         # initial repository, but feel free to use the main repository
 764         # machine to pull updates.
 765         cvsup /usr/share/examples/cvsup/DragonFly-cvs-supfile
 766         # install the source from the CVS hierarchy (remove preexisting
 767         # FreeBSD src first) (500MB)
 768         cd /usr
 769         rm -rf src
 770         cvs -R -d /home/dcvs checkout -P src
 771
 772         # build it (500MB used in /usr/obj)
 773         #
 774         cd /usr/src
 775         make buildworld
 776         make buildkernel KERNCONF=<KERNELNAME>
 777
 778 Once you have built DragonFly you have to install it over FreeBSD.  Since
 779 DragonFly does not track changes made by FreeBSD to its include file
 780 hierarchy and include file pollution can cause all sorts of unexpected
 781 compilation issues to come up, it is best to wipe your include hierarchy
 782 prior to installing DragonFly.  Note that you should not wipe any installed
 783 FreeBSD header files or binaries until after you have successfully completed
 784 the build steps above.
 785
 786         rm -rf /usr/include
 787         mkdir /usr/include
 788         make installkernel KERNCONF=<KERNELNAME>
 789         make installworld
 790
 791 Then you need to upgrade your system.  DragonFly's 'make upgrade' target
 792 will unconditionally upgrade the /etc files that sysops do not usually
 793 mess around with, such as the files in /etc/rc.d.  It will also remove any
 794 obsolete files such as utilities and manpages that have been removed from
 795 the system since the version you're coming from.  If you are unsure we
 796 recommend that you make a backup of at least your /etc before applying
 797 this step.  Note that DragonFly's RC system is basically RCNG from
 798 FreeBSD-5, but there are some differences in the contents of the RC files.
 799
 800         make upgrade
 801
 802 NOTE! Never do a 'make upgrade' before 'make installworld' has been run.
 803 Doing so might leave your system in an unusable state.
 804
 805 Finally we recommend that you do an 'ls -lta BLAH' for /bin, /sbin, /usr/bin,
 806 /usr/bin, and /usr/lib, and remove any stale files that you find.  Please
 807 report these files to the DragonFly developers so that they can be added to
 808 the 'upgrade' target.
 809