Commit | Line | Data |
---|---|---|
d2a0decc MD |
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. | |
d2a0decc | 10 | |
ae75c143 SW |
11 | +-----------------------------------------------------------------------+ |
12 | + UPGRADING DRAGONFLY FROM 6.0 TO LATER VERSIONS + | |
13 | +-----------------------------------------------------------------------+ | |
14 | ||
08f7a79f SW |
15 | A.OUT AND GZIPPED A.OUT EXECUTABLE SUPPORT REMOVED |
16 | -------------------------------------------------- | |
17 | ||
18 | These have not been useful for a long time, if ever. | |
19 | ||
c719bfed SW |
20 | ACPI_NO_SEMAPHORES OPTION REMOVED |
21 | --------------------------------- | |
22 | ||
23 | The ACPI_NO_SEMAPHORES kernel configuration option has been removed. It | |
24 | was never part of our default kernel config. | |
25 | ||
ae75c143 SW |
26 | NDIS DRIVER REMOVED |
27 | ------------------- | |
28 | ||
29 | The ndis(4) driver has been removed. The NDISAPI kernel option has been | |
30 | made a no-op and will be removed at a later point in time. Users with a | |
31 | custom kernel configuration can remove this option from it now. | |
32 | ||
c0af9a0d | 33 | +-----------------------------------------------------------------------+ |
34 | + UPGRADING DRAGONFLY FROM 5.6 TO LATER VERSIONS + | |
35 | +-----------------------------------------------------------------------+ | |
36 | ||
628f4db5 | 37 | BINUTILS 2.34 REPLACES 2.25, PRIMARY |
38 | ------------------------------------ | |
39 | ||
40 | The oldest of the two versions of Binutils, version 2.25, was removed | |
41 | and replaced with Binutils 2.34. It becomes the primary version of | |
42 | binutils and version 2.27 becomes the alternate. | |
43 | ||
44 | The accepted values of BINUTILSVER are now "binutils234" (default) and | |
45 | "binutils227". The building of Binutils 2.27 can be prevented by setting | |
46 | NO_ALTBINUTILS=yes in make.conf | |
47 | ||
a0f1cde0 | 48 | LIBRADIUS AND LIBTACPLUS REMOVED |
49 | -------------------------------- | |
50 | ||
51 | Both libraries have been moved from base to DPorts net/ category. | |
52 | ||
b8bfb053 | 53 | PAM_SSH MODULE REMOVED |
54 | ---------------------- | |
55 | ||
56 | The pam_ssh(8) have been removed from base to DPorts security/pam_ssh. | |
57 | ||
e2e9821d SW |
58 | UTMP LEGACY API REMOVED |
59 | ----------------------- | |
60 | ||
61 | The legacy "utmp" API (getutent() and friends, utmp.h, etc.) has been | |
62 | removed, and we are now using the POSIX "utmpx" API (getutxent(), | |
63 | utmpx.h, etc.) only. The most visible change for users is that the | |
64 | /var/log/wtmp file will no longer be written to, just /var/log/wtmpx. | |
65 | The wtmpcvt(1) utility is provided to convert old wtmp format files to | |
66 | wtmpx. | |
67 | ||
68 | To not break old applications, the utmp symbols are still provided by | |
69 | libc as dummy functions that do nothing and always succeed. | |
70 | ||
b2223336 SW |
71 | TIMED AND TIMEDC REMOVED |
72 | ------------------------ | |
73 | ||
74 | timed(8) and timedc(8) have been removed because they are beyond | |
75 | obsolete for setting the time. | |
76 | ||
c0af9a0d | 77 | LIBOPIE, LIBMD REMOVED |
78 | ---------------------- | |
79 | ||
80 | Removal of OPIE requires /etc/pam.d/ configs to be updated. | |
81 | ||
5c1170ce SW |
82 | +-----------------------------------------------------------------------+ |
83 | + UPGRADING DRAGONFLY FROM 5.4 TO LATER VERSIONS + | |
84 | +-----------------------------------------------------------------------+ | |
85 | ||
92a42612 | 86 | GCC50 REMOVED |
87 | ------------- | |
88 | ||
89 | The GCC50 compiler has been retired. It has been replaced by a GCC80. | |
90 | The default alternative compiler has stayed the same - GCC47. | |
91 | ||
92 | ||
ee3ebee6 SW |
93 | PUFFS, PUTTER AND LIBREFUSE REMOVED |
94 | ----------------------------------- | |
95 | ||
96 | The puffs(4)/putter(4) subsystem has been removed, along with librefuse, | |
97 | libpuffs, and the mount_psshfs(8) utility. All of these have never been | |
98 | working correctly. | |
99 | ||
5c1170ce SW |
100 | FFS_ROOT OPTION REMOVED |
101 | ----------------------- | |
102 | ||
103 | The FFS_ROOT kernel configuration option has been finally removed, after | |
104 | having been a no-op since 4.9. That means users using a custom kernel | |
105 | configuration file that still contains it need to remove the option from | |
106 | that file. | |
107 | ||
d9d67b59 | 108 | +-----------------------------------------------------------------------+ |
6ffa2848 | 109 | + UPGRADING DRAGONFLY FROM 5.2 TO LATER VERSIONS + |
d9d67b59 SW |
110 | +-----------------------------------------------------------------------+ |
111 | ||
c585ae0f SW |
112 | DIGI, RP AND SI DRIVERS REMOVED |
113 | ------------------------------- | |
114 | ||
115 | The digi(4), rp(4) and si(4) serial drivers have been removed. None of | |
116 | them were in our default kernel configuration file. The sicontrol(8) | |
117 | utility was removed, too. | |
118 | ||
e79a303f AL |
119 | MKINITRD COMMAND REMOVED |
120 | ------------------------ | |
121 | ||
122 | The mkinitrd(8) command is removed and its functionality is replaced by | |
123 | the new "initrd" make target. After rebooting into the new world and | |
124 | verifying everything works, execute "make initrd" to upgrade the rescue | |
125 | tools and initrd image. | |
126 | ||
755d70b8 SW |
127 | IPSEC, IPSEC_ESP AND IPSEC_DEBUG REMOVED FROM VKERNEL64 CONFIG |
128 | -------------------------------------------------------------- | |
129 | ||
130 | IPsec has been removed from the system. Of our standard kernel | |
131 | configurations, only the virtual kernel one had it. People running | |
132 | vkernels with configuration files derived from our VKERNEL64 will | |
133 | have to remove these options manually. | |
134 | ||
6ffa2848 SW |
135 | +-----------------------------------------------------------------------+ |
136 | + UPGRADING DRAGONFLY FROM 5.0 TO LATER VERSIONS + | |
137 | +-----------------------------------------------------------------------+ | |
138 | ||
c07d5880 SW |
139 | VIRTIO_PCI REMOVED FROM KERNEL CONFIG |
140 | ------------------------------------- | |
141 | ||
142 | The "device virtio_pci" line in X86_64_GENERIC has been removed. People | |
143 | with configuration files derived from it have to remove it manually. | |
144 | ||
2458c6f4 SW |
145 | VARIOUS 'R' COMMANDS AND DAEMONS REMOVED |
146 | ---------------------------------------- | |
147 | ||
148 | rcp(1), rlogin(1), rlogind(8), rsh(1) and rshd(8) have been removed. | |
149 | For those that still need them, there is the net/bsdrcmds port. | |
150 | ||
a26d33cf SW |
151 | VARIOUS FORMER OPTIONS REMOVED |
152 | ------------------------------ | |
153 | ||
154 | Various former kernel configuration options which had been no-ops for | |
155 | some time were completely removed: SYSVMSG, SYSVSEM, SYSVSHM, P1003_1B, | |
156 | _KPOSIX_VERSION and DSCHED_FQ. Users that have any of these still in | |
157 | their kernel configuration files have to remove them. | |
158 | ||
a90cc0c2 | 159 | BOOTSTRAPPING LIMITED FROM PRE 4.4 |
160 | ---------------------------------- | |
161 | ||
162 | Upgrading to 5.1 and later versions now require at least 4.4 in | |
163 | preparations for upcoming base compilers updates. | |
164 | ||
06937ef9 SW |
165 | IF_PPP, PPPD, IF_FAITH, AND FAITHD REMOVED |
166 | ------------------------------------------ | |
a90cc0c2 | 167 | |
06937ef9 | 168 | if_ppp has been replaced by "user ppp", i.e. ppp(8) and tun(4). It had |
d9d67b59 SW |
169 | already been removed from our default kernel configuration before 5.0, |
170 | so only people with custom configurations based on earlier X86_64_GENERIC | |
171 | will have to remove it manually. | |
172 | ||
06937ef9 SW |
173 | The faith(4) interface has been completely removed after it had also |
174 | been removed from our default kernel configuration. | |
175 | ||
1b2d852e SW |
176 | +-----------------------------------------------------------------------+ |
177 | + UPGRADING DRAGONFLY FROM 4.8 TO LATER VERSIONS + | |
178 | +-----------------------------------------------------------------------+ | |
179 | ||
180 | FFS_ROOT OPTION DISABLED | |
181 | ------------------------ | |
182 | ||
183 | The FFS_ROOT option has been made a no-op and will be completely removed | |
184 | at some point in the future. Users with a custom kernel configuration | |
185 | can remove this option from it now. | |
186 | ||
3522bdfe SW |
187 | +-----------------------------------------------------------------------+ |
188 | + UPGRADING DRAGONFLY FROM 4.6 TO LATER VERSIONS + | |
189 | +-----------------------------------------------------------------------+ | |
190 | ||
4d6bb23e JS |
191 | DSA OPENSSH KEYS DEPRECATED |
192 | --------------------------- | |
193 | ||
194 | Note that DSA OpenSSH keys were deprecated in the 4.6 to 4.8 release. | |
195 | If you are upgrading from a release older than 4.8 and use DSA OpenSSH | |
196 | keys, please update your private/public key pair or risk locking | |
197 | yourself out. | |
198 | ||
7efec73e SW |
199 | AHC, AHD, AIC, NCV, NSP AND STG DRIVERS REMOVED |
200 | ----------------------------------------------- | |
9ef43fc3 | 201 | |
7efec73e SW |
202 | They were all in our X86_64_GENERIC kernel configuration file, along with |
203 | the AHC_REG_PRETTY_PRINT and AHD_REG_PRETTY_PRINT options, so any custom | |
204 | configuration files derived from it need adjustment. | |
9ef43fc3 | 205 | |
be813d7a SW |
206 | PORTAL FILE SYSTEM REMOVED |
207 | -------------------------- | |
208 | ||
209 | It has been broken for a long time now. | |
210 | ||
5cc5a38c | 211 | BINUTILS 2.27 REPLACES 2.24, PRIMARY |
212 | ------------------------------------ | |
213 | ||
214 | The oldest of the two versions of Binutils, version 2.24, was removed | |
215 | and replaced with Binutils 2.27. It becomes the primary version version | |
216 | of binutils and version 2.25 becomes the alternate. | |
217 | ||
218 | The accepted values of BINUTILSVER are now "binutils227" (default) and | |
219 | "binutils225". The building of Binutils 2.25 can be prevented by setting | |
220 | NO_ALTBINUTILS=yes in make.conf. | |
221 | ||
d6e8ab2d SW |
222 | COMPAT_43 KERNEL OPTION REMOVED |
223 | ------------------------------- | |
224 | ||
225 | It was commented out in our default configs for several years now, but | |
226 | might still be present in custom configs created before Nov. 2011. | |
227 | ||
adfb2c71 JM |
228 | OPENSSL REMOVED |
229 | --------------- | |
230 | ||
231 | OpenSSL has been removed from base and replaced with a private version of | |
232 | LibreSSL. The previously installed OpenSSL libraries, headers, and man | |
233 | pages will remain on the system unless the "make upgrade" command is | |
234 | specifically instructed to remove them. To do this, define | |
235 | REMOVE_OPENSSL_FILES for the upgrade command, e.g. | |
236 | "make upgrade REMOVE_OPENSSL_FILES=yes" | |
237 | ||
5b245968 MD |
238 | 28-Oct-2016: openssl has been replaced by ressl. It is recommended that any |
239 | stale OpenSSL files be removed to avoid configuration scripts from using | |
240 | the stale and potentially vulnerable version, but all binaries that are | |
241 | dynamically linked to the OpenSSL libraries should be rebuilt first to | |
242 | avoid breakage. | |
adfb2c71 | 243 | |
9682bad8 TN |
244 | OPENSSH HPN REMOVED |
245 | ------------------- | |
246 | ||
247 | It has become too cumbersome to maintain HPN patches in OpenSSH in base. | |
248 | To use OpenSSH in base remove HPN config, if you have added it. | |
249 | Check files below for HPN config, see a few lines below. | |
250 | /etc/ssh/ssh_config, /etc/ssh/sshd_config, ~/.ssh/config | |
251 | sshd(8) will fail to start if HPN config is used. | |
252 | ||
253 | NOTE: HPN config in sshd_config will prohibit remote access to host using ssh. | |
254 | ||
255 | HPN config: | |
256 | HPNDisabled | |
257 | HPNBufferSize | |
258 | TcpRcvBuf | |
259 | TcpRcvBufPoll | |
260 | NoneEnabled | |
261 | NoneSwitch | |
262 | cipher MTR-AES-CTR | |
263 | cipher NONE | |
264 | ||
265 | OpenSSH HPN is a patch set to OpenSSH providing higher performance under some | |
266 | circumstances, especially for networking. | |
267 | If HPN functionality is needed, install security/openssh from dports. | |
268 | ||
859c2e53 SW |
269 | CS, EX AND VX DRIVERS REMOVED |
270 | ----------------------------- | |
3522bdfe | 271 | |
859c2e53 SW |
272 | The cs(4), ex(4) and vx(4) drivers have been removed. They were very |
273 | old and its doubtful they ever worked properly in x86_64 but they were | |
274 | in X86_64_GENERIC, so custom configurations derived from it have to be | |
3a609f3d | 275 | adjusted. |
3522bdfe | 276 | |
82aec1d3 FT |
277 | +-----------------------------------------------------------------------+ |
278 | + UPGRADING DRAGONFLY FROM 4.4 TO LATER VERSIONS + | |
279 | +-----------------------------------------------------------------------+ | |
280 | ||
f1826c3e SW |
281 | AMD REMOVED |
282 | ----------- | |
283 | ||
284 | The am-utils automounter suite has been removed. It stopped working | |
285 | at some point and was never fixed. autofs(5) and the associated | |
286 | userland has been brought in from FreeBSD and replaces it. | |
287 | ||
c222305f SW |
288 | AN DRIVER REMOVED |
289 | ----------------- | |
82aec1d3 | 290 | |
c222305f SW |
291 | The an(4) driver has been removed. It was in the X86_64_GENERIC kernel |
292 | config file, so any configurations derived from it have to be adjusted. | |
82aec1d3 | 293 | |
c222305f SW |
294 | /DEV/DRI GROUP CHANGED |
295 | ---------------------- | |
296 | ||
297 | The default group assigned to /dev/dri entries has been changed | |
298 | from 'wheel' to 'video' with the id of '44'. If you want to have | |
299 | access to the dri devices please add yourself to the video group | |
300 | with: | |
301 | ||
302 | # pw groupmod video -m $USER | |
82aec1d3 | 303 | |
dbf3d3ba JM |
304 | +-----------------------------------------------------------------------+ |
305 | + UPGRADING DRAGONFLY FROM 4.2 TO LATER VERSIONS + | |
306 | +-----------------------------------------------------------------------+ | |
307 | ||
54af9d02 SW |
308 | DSCHED REMOVED |
309 | -------------- | |
310 | ||
311 | dsched(4) has been removed and one of its kernel options, DSCHED_FQ, was | |
312 | in our default kernel config file. So the DSCHED_FQ option has been turned | |
313 | into a no-op for now and can be removed from custom configurations. | |
314 | ||
68ef81ed SW |
315 | EST DRIVER REMOVED, COMPILE_ET AND LIBCOM_ERR TOO |
316 | ------------------------------------------------- | |
317 | ||
318 | The est(4) driver has been removed. All CPUs it supported (except one) | |
319 | were 32 bits only. Those who are still using the Core 2 Duo T7500 should | |
320 | report back if there are any issues with this CPU and our regular ACPI | |
321 | P-state support. | |
322 | ||
323 | Also, compile_et(1) and com_err(3) have been removed as well. They | |
324 | should have been removed along with kerberos support, back in 2009. | |
325 | ||
dbf3d3ba JM |
326 | SEVERAL LOCALES RENAMED |
327 | ----------------------- | |
328 | ||
329 | Several locales were using obsolete and misleading names, and thus have | |
330 | been adjusted to current standards. Any users of the following locales | |
331 | need to select alternates: | |
332 | ||
333 | DFLY 4.2 locale DFLY 4.4 alterative locale | |
334 | --------------- ------------------------------------ | |
335 | mn_MN.UTF-8 mn_Cyrl_MN.UTF-8 | |
336 | no_NO.UTF-8 nb_NO.UTF-8 or nn_NO.UTF-8 | |
337 | no_NO.ISO8859-1 nb_NO.ISO8869-1 or nn_NO.ISO8859-1 | |
338 | no_NO.ISO8859-15 nb_NO.ISO8859-15 or nn_NO.ISO8859-15 | |
339 | sr_YU.UTF-8 sr_Cyrl_RS.UTF-8 or sr_Latn_RS.UTF-8 | |
340 | sr_YU.ISO8859-5 sr_Cyrl_RS.ISO8859-5 | |
341 | sr_YU.ISO8859-2 sr_Latn_RS.ISO8859-2 | |
342 | zh_CN.GBK zh_Hans_CN.GBK | |
343 | zh_CN.UTF-8 zh_Hans_CN.UTF-8 | |
344 | zh_CN.eucCN zh_Hans_CN.eucCN | |
345 | zh_CN.GB2312 zh_Hans_CH.GB2312 | |
346 | zh_CN.GB18030 zh_Hans_CH.GB18030 | |
347 | zh_HK.Big5HKSCS zh_Hant_HK.Big5HKSCS | |
348 | zh_HK.UTF_8 zh_Hant_HK.UTF-8 | |
349 | zh_TW.Big5 zh_Hant_TW.Big5 | |
350 | zh_TW.UTF-8 zh_Hant_TW.UTF-8 | |
351 | ||
2a617999 SW |
352 | +-----------------------------------------------------------------------+ |
353 | + UPGRADING DRAGONFLY FROM 4.0 TO LATER VERSIONS + | |
354 | +-----------------------------------------------------------------------+ | |
355 | ||
65c3b857 JM |
356 | BINUTILS 2.25 REPLACES 2.22, PRIMARY |
357 | ------------------------------------ | |
358 | ||
359 | The oldest of the two versions of Binutils, version 2.22, was removed | |
360 | and replaced with Binutils 2.25. It becomes the primary version version | |
361 | of binutils and version 2.24 becomes the alternate. There are 8 current | |
362 | CVE written against 2.24, so for security reasons version 2.25 should | |
363 | always be used. | |
364 | ||
365 | The accepted values of BINUTILSVER are now "binutils225" (default) and | |
366 | "binutils224". The building of Binutils 2.24 can be prevented by setting | |
367 | NO_ALTBINUTILS=yes in make.conf. | |
368 | ||
72b78560 JM |
369 | LOADER OPTIONS CHANGED |
370 | ---------------------- | |
371 | ||
372 | Right after the development branch started, the Fred art accompanying the | |
373 | loader menu was improved. The line between Fred and the menu was removed | |
374 | by default (but can optionally be returned) and the placement shifted as | |
375 | a result. The drawing was improved, and the colored version was improved, | |
376 | changing the eyes and wing color from white to red. A new color version | |
377 | of Fred was added, one with a blue scheme. | |
378 | ||
379 | The loader menu defaults have changed since release 4.0: The vertical | |
380 | line was removed, the loader is displayed in color by default*, and the | |
381 | blue scheme is used. | |
382 | ||
383 | The loader.conf changes are: | |
384 | loader_color: option has been removed | |
385 | loader_plain: option has been added, it changed menu to monochrome | |
386 | fred_is_red: changes color scheme from blue to red | |
387 | fred_is_blue: option existed only on 4.1, it has been removed | |
388 | fred_separated: Adds line between Fred and menu (as seen previously) | |
389 | ||
390 | * If loader.conf defines "console" as "comconsole" or "console" is defined | |
391 | in the environment as "comconsole" then color will not be displayed, | |
392 | even if loader_plain value is "NO". | |
393 | ||
cbab4ab1 JM |
394 | SENDMAIL REMOVED FROM BASE |
395 | -------------------------- | |
396 | ||
397 | The only Mail Transfer Agent provided now is DragonFly Mail Agent (dma). | |
398 | If the system being upgraded is still configured to use the sendmail | |
399 | binaries from base, the "make upgrade" command will fail. | |
400 | ||
401 | The administrator must change /etc/mail/mailer.conf to switch the | |
402 | mailwrapper to dma or a DPorts-based MTA prior to running the upgrade | |
403 | command that permanently removes sendmail executables and could | |
404 | potentially break a running mail server. | |
405 | ||
406 | Refer: http://www.dragonflybsd.com/docs/docs/newhandbook/mta/ for | |
407 | detailed instructions on how to configure the MTA selection. | |
408 | ||
a7ac1ee9 SW |
409 | _KPOSIX_VERSION and P1003_1B OPTIONS REMOVED |
410 | -------------------------------------------- | |
411 | ||
412 | The _KPOSIX_VERSION and P1003_1B kernel options have been changed to | |
413 | no-ops. They can be removed from custom kernel configurations. | |
414 | ||
aa7c3d6b FT |
415 | SOUND SYSTEM UPDATED FROM FreeBSD 11-CURRENT |
416 | -------------------------------------------- | |
417 | ||
418 | Many more sound devices may be detected. | |
419 | ||
bbb35c81 | 420 | If the default device chosen isn't to your liking, setting the sysctl |
aa7c3d6b FT |
421 | hw.snd.default_unit to a different number will change it. |
422 | ||
60a260ad SW |
423 | SCTP SUPPORT DROPPED |
424 | -------------------- | |
425 | ||
426 | Support for the SCTP protocol has been removed. | |
427 | ||
2a617999 SW |
428 | OLD USB DRIVERS REMOVED |
429 | ----------------------- | |
430 | ||
431 | The old USB stack, along with the kernel config option "device oldusb" | |
432 | and the make.conf variable "WANT_OLDUSB" have been removed. This means | |
433 | that for custom kernel configuration files which were derived from a | |
434 | GENERIC or X86_64_GENERIC file prior to making the usb4bsd stack default, | |
435 | various (old USB stack specific) devices will now complain about being | |
436 | unknown: | |
437 | ||
438 | * oldusb (obviously) | |
439 | * natausb (not yet ported to usb4bsd) | |
440 | * rue (not yet ported to usb4bsd) | |
441 | * ugen (no longer needed in usb4bsd) | |
442 | * urio (not yet ported to usb4bsd) | |
443 | * uscanner (no longer needed in usb4bsd) | |
444 | ||
445 | They should be removed or commented out in such custom kernel configs. | |
446 | ||
4e8e707f JM |
447 | GCC 5 |
448 | ----- | |
449 | ||
450 | The GCC 4.4 compiler has been retired. It has been replaced by a GCC 5.1. | |
451 | The following make.conf variables no longer work: NO_GCC44, NO_OBJC, and | |
452 | NO_CXX. The latter was never documented and the latest versions of GCC are | |
453 | partially written in C++ so a C++ compiler is no longer optional. In | |
454 | practical terms it has not been optional for many years as other base | |
455 | components are also written in C++. The resource savings by avoiding | |
456 | building Objective-C compiler is so small, the complexity added by NO_OBJC | |
457 | internally was deemed a bad tradeoff so that is the reason for its removal. | |
458 | Also note that no "info" pages are installed with GCC 5. After this entry | |
459 | was originally written, all info pages were removed from DragonFly. | |
460 | ||
461 | GCC 5.1 has been designated as the primary compiler. As such, there is a | |
462 | new make.conf variable, NO_ALTCOMPILER. It will block the rebuilding of | |
463 | the designated secondary compiler, GCC 4.7. However, while DPorts | |
464 | primarily uses GCC 5 to build ports now, it still uses GCC 4.7 as well, so | |
465 | if building ports from source is desired, don't block building of the | |
466 | secondary compiler. | |
e9b676f1 | 467 | |
0055c35b SW |
468 | +-----------------------------------------------------------------------+ |
469 | + UPGRADING DRAGONFLY FROM 3.8 TO LATER VERSIONS + | |
470 | +-----------------------------------------------------------------------+ | |
471 | ||
2a617999 | 472 | SMP AND DEVICE_POLLING OPTIONS MADE UNKNOWN |
39b3e0a1 SW |
473 | ------------------------------------------- |
474 | ||
475 | DEVICE_POLLING was replaced by IFPOLL_ENABLE and the former SMP code is | |
476 | the default now (even on single-core systems), both for, like, 21 months. | |
477 | We kept the options around as no-ops as a convenience, to allow people | |
478 | using the same config for the then current release and the then current | |
479 | master. That period is now over, so any configs still having those | |
480 | options have to be adjusted. | |
481 | ||
10ceb702 SW |
482 | SYSVIPC SYSCALLS MADE NON-OPTIONAL |
483 | ---------------------------------- | |
484 | ||
485 | The code related to the SYSVMSG, SYSVSEM and SYSVSHM kernel options is | |
486 | now compiled in by default. The options are no-ops for now. | |
487 | ||
79a3e83f SW |
488 | DEFAULT DRIVER CHANGED FOR LSI "THUNDERBOLT" SERIES RAID CONTROLLERS |
489 | -------------------------------------------------------------------- | |
490 | ||
491 | The default driver for those controllers is now mrsas(4) due to reports | |
492 | of file system corruption using the mfi(4) driver. The whole issue (and | |
493 | how to deal with potential problems when switching) was explained here: | |
494 | ||
495 | http://lists.dragonflybsd.org/pipermail/users/2014-July/128703.html | |
496 | ||
497 | A tunable is provided for letting those controllers still attach via | |
498 | the mfi(4) driver, hw.mrsas.mfi_enable (see mrsas(4) manual page). | |
499 | ||
0055c35b SW |
500 | OLDER NETWORK DRIVERS MOVED TO I386 ONLY |
501 | ---------------------------------------- | |
502 | ||
503 | The following drivers have been made i386 only: ed(4), sr(4), ng_sync_ar | |
504 | and ng_sync_sr. ed(4) used to be in X86_64_GENERIC, so it has to be | |
505 | removed in kernel configs derived from X86_64_GENERIC. | |
506 | ||
e19e3c77 | 507 | +-----------------------------------------------------------------------+ |
62d4130d | 508 | + UPGRADING DRAGONFLY FROM 3.6 TO LATER VERSIONS + |
e19e3c77 SW |
509 | +-----------------------------------------------------------------------+ |
510 | ||
a6a7c140 JS |
511 | UPDATE FROM MOST RECENT 3.6 |
512 | --------------------------- | |
513 | ||
514 | Versions of 3.6 built before June 25th have a bug where installworld might | |
515 | crash during installation of the new initrd. Upgrade to the latest version | |
516 | of 3.6 before updating to 3.8 or later. | |
517 | ||
7c87aae6 SW |
518 | ATM, IPX, NCP AND NWFS SUPPORT DROPPED |
519 | -------------------------------------- | |
6f25d555 SW |
520 | |
521 | Support for the IPX and NCP network protocols and for mouting NetWare | |
7c87aae6 | 522 | file systems has been dropped. Dito for ATM protocol support. |
6f25d555 SW |
523 | |
524 | INITRD IMAGES NOW INSTALLED BY DEFAULT | |
525 | -------------------------------------- | |
526 | ||
527 | An initial ramdisk image is now installed in /boot/kernel/initrd.img.gz | |
528 | ||
529 | Older images installed under the file name of initrd.img will be removed | |
530 | automatically by the make upgrade process. | |
531 | ||
f0478b8b SW |
532 | USB4BSD IS NOW THE DEFAULT USB STACK |
533 | ------------------------------------ | |
534 | ||
535 | To get back to the old stack, put "WANT_OLDUSB=yes" in /etc/make.conf and | |
536 | replace "device usb" with "device oldusb" in the kernel configuration. | |
537 | ||
e19e3c77 SW |
538 | MORE ISA SUPPORT DROPPED |
539 | ------------------------ | |
540 | ||
541 | ISA support has been dropped from the following drivers: adv(4), an(4), | |
542 | ar(4), cs(4), digi(4), ed(4), ep(4), ex(4), fe(4), lnc(4), sbni(4), | |
543 | si(4), sn(4), and stg(4). | |
544 | ||
9332798a | 545 | +-----------------------------------------------------------------------+ |
62d4130d | 546 | + UPGRADING DRAGONFLY FROM 3.4 TO LATER VERSIONS + |
9332798a SW |
547 | +-----------------------------------------------------------------------+ |
548 | ||
c04df145 JS |
549 | ABI CHANGE |
550 | ---------- | |
551 | ||
552 | Installed third-party software (dports) will have to be rebuilt after upgrade, | |
553 | or reinstalled from binary packages. | |
554 | ||
2b455b95 JS |
555 | UPDATING FROM 3.4 TO 3.6 |
556 | ------------------------ | |
557 | ||
558 | This only applies for this specific upgrade due to locale changes; it is | |
559 | not needed for upgrades after 3.6. Please update in this order: | |
560 | ||
561 | make buildworld | |
562 | make buildkernel | |
563 | make installworld | |
564 | make installkernel | |
565 | *reboot* | |
566 | make upgrade | |
567 | ||
568 | See this mailing list post for details: | |
569 | http://lists.dragonflybsd.org/pipermail/users/2013-September/090163.html | |
570 | ||
9332798a SW |
571 | CYRIX OPTIONS REMOVED |
572 | --------------------- | |
573 | ||
574 | The following Cyrix related options have been removed: CPU_BTB_EN, | |
575 | CPU_CYRIX_NO_LOCK, CPU_DIRECT_MAPPED_CACHE, CPU_DISABLE_5X86_LSSER, | |
576 | CPU_FASTER_5X86_FPU, CPU_IORT, CPU_LOOP_EN, CPU_RSTK_EN, CPU_SUSP_HLT, | |
577 | CYRIX_CACHE_WORKS, and CYRIX_CACHE_REALLY_WORKS | |
578 | ||
579 | ISA SUPPORT REMOVED FROM RP(4) | |
580 | ------------------------------ | |
581 | ||
582 | ISA support has been removed from the rp(4) driver. It is now PCI only. | |
583 | ||
64aeb497 | 584 | +-----------------------------------------------------------------------+ |
62d4130d | 585 | + UPGRADING DRAGONFLY FROM 3.2 TO LATER VERSIONS + |
64aeb497 SW |
586 | +-----------------------------------------------------------------------+ |
587 | ||
d88b9605 SW |
588 | COMPAT_SUNOS OPTION REMOVED |
589 | --------------------------- | |
590 | ||
591 | The COMPAT_SUNOS option has been removed. It was meant to provide binary | |
592 | compatibility with SunOS 4.x for the sparc32 port of 4.4BSD. | |
593 | ||
43f215d7 SW |
594 | ISA SOUND CARD SUPPORT REMOVED |
595 | ------------------------------ | |
596 | ||
597 | The following modules have been removed (all for ISA sound cards): | |
598 | snd_ad1816.ko, snd_ess.ko, snd_mss.ko, snd_sb8.ko, snd_sb16.ko, snd_sbc.ko | |
599 | ||
6100d1de JM |
600 | GCC 4.7 |
601 | ------- | |
602 | ||
603 | DragonFly has switched base compilers. GCC 4.7 is now the default | |
604 | compiler and GCC 4.4 is the alternative compiler. The "NO_GCC47" make | |
605 | variable ceases to work now. | |
606 | ||
607 | Users who wish to build only GCC 4.7 have to use NO_GCC44 in the | |
608 | /etc/make.conf to prohibit GCC 4.4 from building. However, using it is | |
609 | highly discouraged. There are a few packages in pkgsrc that do not build | |
610 | with GCC 4.7 and the new "DPorts" system uses GCC 4.4 by default. At | |
611 | this time, it is recommended to keep both compilers on the base system. | |
612 | ||
2089bb7c SW |
613 | SMP OPTION REMOVED |
614 | ------------------ | |
615 | ||
616 | The SMP kernel option has been made a no-op. All kernels now feature SMP | |
617 | support. If you have 'options SMP' in your kernel config, you can as well | |
618 | remove it. | |
619 | ||
1c297ed0 SW |
620 | DEVICE_POLLING OPTION REPLACED BY IFPOLL_ENABLE OPTION, KTR_POLLING REMOVED |
621 | --------------------------------------------------------------------------- | |
640dc18f SZ |
622 | |
623 | The DEVICE_POLLING kernel option has been made a no-op and it has been | |
624 | replaced by IFPOLL_ENABLE. If you have 'options DEVICE_POLLING' in your | |
625 | kernel config, you need to change it to IFPOLL_ENABLE. | |
626 | ||
1c297ed0 SW |
627 | Also, the KTR_POLLING kernel option has been removed, so it must be |
628 | removed from kernel configs that have it. | |
629 | ||
558b0a0b SW |
630 | BUSLOGIC, CYCLADES AND STALLION ISA SUPPORT REMOVED |
631 | --------------------------------------------------- | |
850c4634 SW |
632 | |
633 | The bt(4) driver for Buslogic SCSI adapters has been made PCI only. ISA | |
634 | cards will no longer be detected. | |
635 | ||
e6f626a1 SW |
636 | The same has been done for Stallion multiport serial controllers. stli(4) |
637 | has been completely removed (along with the stlload(8) and stlstty(8) | |
558b0a0b SW |
638 | utilities) and stl(4) was changed to support only PCI cards. Similarly, |
639 | ISA support was removed from cy(4) too. All these drivers are i386 only. | |
e6f626a1 | 640 | |
e98bcb27 SW |
641 | COMPAT_OLDISA OPTION GONE |
642 | ------------------------- | |
643 | ||
644 | The i386 specific COMPAT_OLDISA kernel option has been removed, since | |
645 | nothing needs it anymore. | |
646 | ||
c691bb43 | 647 | +-----------------------------------------------------------------------+ |
62d4130d | 648 | + UPGRADING DRAGONFLY FROM 3.0 TO LATER VERSIONS + |
c691bb43 SW |
649 | +-----------------------------------------------------------------------+ |
650 | ||
651 | APIC_IO OPTION REMOVED | |
652 | ---------------------- | |
653 | ||
654 | The APIC_IO kernel option is no longer accepted after having been without | |
655 | effect for a while. The hw.ioapic_enable tunable now serves its purpose. | |
656 | If you have 'options APIC_IO' in your kernel config, you'll have to | |
657 | remove it. | |
658 | ||
6d488cc3 SW |
659 | WATCHDOG_ENABLE & HW_WDOG OPTIONS REMOVED |
660 | ----------------------------------------- | |
cf03d6cd SW |
661 | |
662 | The wdog framework is now compiled into our kernels by default, so the | |
6d488cc3 | 663 | options are no longer needed. |
cf03d6cd | 664 | |
397ffc5c SW |
665 | DOSCMD(1) REMOVED |
666 | ----------------- | |
667 | ||
668 | doscmd(1) has been removed. It was i386 only. The doscmd(1) specific | |
669 | NO_X make.conf option was removed too. | |
670 | ||
a1404d4f SW |
671 | GCC 4.7 |
672 | ------- | |
673 | ||
674 | GCC 4.7 has been brought in and replaces GCC 4.1 as DragonFly's non- | |
675 | default compiler in base (default is still GCC 4.4). | |
676 | ||
677 | Users who wish to build only GCC 4.4 have to replace NO_GCC41 with | |
678 | NO_GCC47 in /etc/make.conf. | |
679 | ||
2508820f SW |
680 | USB4BSD |
681 | ------- | |
682 | ||
683 | A new USB stack (from FreeBSD) has been brought in. The following | |
684 | modules have been ported so far: usb, uhci, ohci, ehci, xhci, umass, | |
685 | usfs, uether, if_axe, if_udav, ukbd, ums, uep, uhid, usb_quirk, | |
686 | and uaudio. | |
687 | ||
688 | It is not yet the default. To activate it, WANT_USB4BSD=yes has to | |
c7200221 SW |
689 | be put in make.conf and device "usb4bsd" (quotes needed) has to |
690 | replace device usb in the kernel config. After that, a full | |
691 | build/install/upgrade cycle is needed. | |
2508820f SW |
692 | |
693 | Note that this is experimental and incomplete, but we are interested | |
694 | in hearing about issues with it, of course. | |
695 | ||
ae0870a3 SW |
696 | ISA SUPPORT REMOVED FROM AIC-6260/6360 DRIVER |
697 | --------------------------------------------- | |
698 | ||
699 | ISA adapter support was dropped from the aic(4) driver. | |
700 | ||
96386d4b | 701 | +-----------------------------------------------------------------------+ |
62d4130d | 702 | + UPGRADING DRAGONFLY FROM 2.10 TO LATER VERSIONS + |
96386d4b SW |
703 | +-----------------------------------------------------------------------+ |
704 | ||
705 | SEVERAL ISA DRIVERS REMOVED | |
706 | --------------------------- | |
707 | ||
708 | The following ISA only drivers have been removed along with a couple of | |
709 | associated userland tools: | |
710 | ||
711 | aha(4) | |
712 | asc(4) & sasc(1) | |
713 | ctx | |
714 | dgb(4) | |
715 | el(4) | |
716 | gpib | |
717 | gsc(4) & sgsc(1) | |
718 | ie(4) | |
719 | labpc(4) | |
720 | le(4) | |
721 | mse(4) | |
722 | rc(4) | |
723 | rdp(4) | |
724 | spigot | |
725 | tw(4) & xten(1) & xtend(8) | |
726 | wl(4) & wlconfig(8) | |
727 | wt(4) | |
728 | ||
729 | Note that two of these drivers (aha(4) and ie(4)) are in our GENERIC | |
730 | config and one (aha(4)) is in our X86_64_GENERIC kernel configuration | |
731 | file. | |
732 | ||
733 | If buildkernel complains about any of these drivers, just remove them | |
734 | from your kernel configuration. | |
735 | ||
919eb219 JM |
736 | BINUTILS 2.20 |
737 | ------------- | |
37c5a0db | 738 | Binutils 2.20 has been removed in favor of Binutils 2.22. The accepted |
e685772e | 739 | values of BINUTILSVERS are now binutils221 and binutils222 (default). |
919eb219 | 740 | |
83bc1e2a SW |
741 | BUILDWORLD/-KERNEL PARALLELIZATION WORK |
742 | --------------------------------------- | |
743 | Due to changes in the way we build with more than one make job, you | |
744 | will have to update install(1) and mkdir(1) prior to buildworld if you | |
745 | want to build with 'make -j': | |
746 | ||
747 | cd /usr/src/usr.bin/xinstall; make; make install; make clean | |
748 | cd /usr/src/bin/mkdir; make; make install; make clean | |
749 | ||
eca86bd9 SW |
750 | DMA(8) UPGRADE |
751 | -------------- | |
752 | dma(8) has been upgraded to v0.7 which no longer supports the | |
753 | /etc/dma/virtusertable. Some of its functionality has been replaced | |
754 | with the MASQUERADE keyword and the EMAIL environment variable (see | |
755 | the dma(8) manual page). | |
756 | ||
a4a39c94 | 757 | +-----------------------------------------------------------------------+ |
62d4130d | 758 | + UPGRADING DRAGONFLY FROM 2.8 TO LATER VERSIONS + |
a4a39c94 JS |
759 | +-----------------------------------------------------------------------+ |
760 | ||
b1242318 SW |
761 | GCC 4.4 & BINUTILS 2.21 |
762 | ----------------------- | |
30c91f0c | 763 | |
b1242318 SW |
764 | GCC 4.4 has been made DragonFly's default compiler and Binutils 2.21 has |
765 | been made DragonFly's default Binutils. | |
30c91f0c SW |
766 | |
767 | That means that any settings that set CCVER to 'gcc44' are not needed | |
768 | anymore. Instead, CCVER can be set to 'gcc41' to go back to using | |
769 | GCC 4.1. | |
770 | ||
b1242318 SW |
771 | It also means that 'binutils221' as a value for BINUTILSVER has no |
772 | effect anymore. 2.17 has been removed and 'binutils220' is available | |
773 | as an option. | |
774 | ||
5738210d | 775 | The NO_GCC44 option has been removed and will not affect the build |
30c91f0c SW |
776 | anymore. There is now a NO_GCC41 option that will prevent GCC 4.1 from |
777 | building in a similar fashion. | |
778 | ||
80abb3be | 779 | Note that you must do a full buildworld/buildkernel for upgrading. |
30c91f0c | 780 | |
a4a39c94 | 781 | pkg_radd settings |
c983d16e | 782 | ----------------- |
a4a39c94 JS |
783 | |
784 | The config file for pkg_radd has moved from /etc/settings.conf to | |
785 | /etc/pkg_radd.conf. Save the contents of settings.conf before upgrading | |
786 | if this is needed. This warning only applies if /etc/settings.conf | |
787 | exists. pkg_radd will continue to work with defaults. | |
788 | ||
b79f66dd | 789 | +-----------------------------------------------------------------------+ |
72fe41d3 | 790 | + 20100927 + |
1bb1cc14 | 791 | + UPGRADING DRAGONFLY FROM 2.6 to 2.8 or HEAD + |
b79f66dd JT |
792 | +-----------------------------------------------------------------------+ |
793 | ||
72fe41d3 | 794 | OpenSSL |
c983d16e | 795 | -------- |
72fe41d3 PA |
796 | |
797 | OpenSSL has been upgraded, and SHLIB_MAJOR was bumped for libssh and libcrypto. | |
798 | This shouldn't break any 3rd-party software, but you'll need to recompile your | |
799 | 3rd-party software if you want it to link against the new version of OpenSSL. | |
800 | ||
8eb0b612 | 801 | Loader |
c983d16e | 802 | ------- |
8eb0b612 | 803 | |
b79f66dd JT |
804 | A new loader (dloader) has been added which better handles booting from |
805 | multiple kernel/module versions. | |
806 | ||
807 | To upgrade (Only for this upgrade, for post 2.8 upgrades see GENERAL below) | |
808 | ||
809 | cd /usr/src | |
810 | make buildworld | |
811 | make installworld | |
812 | make upgrade | |
813 | make buildkernel KERNCONF=<KERNELNAME> | |
814 | make installkernel KERNCONF=<KERNELNAME> | |
815 | ||
816 | Note that you must installworld and run the 'upgrade' target before | |
817 | installing the new kernel. | |
818 | ||
8eb0b612 | 819 | BIND |
c983d16e | 820 | ----- |
8eb0b612 JS |
821 | |
822 | BIND has been removed from the base system. The ldns and drill tools have | |
823 | been added for basic functionality. Use 'drill' where you would normally | |
824 | use nslookup or dig, or install BIND from pkgsrc. It's available as | |
825 | net/bind95, net/bind96, or net/bind97 as of this writing. | |
826 | ||
827 | This only affects older systems upgrading to 2.8. New 2.8+ installs | |
828 | include BIND as a pkgsrc package. | |
829 | ||
d2a0decc MD |
830 | +-----------------------------------------------------------------------+ |
831 | + UPGRADING DRAGONFLY ON AN EXISTING DRAGONFLY SYSTEM + | |
832 | + GENERAL + | |
833 | +-----------------------------------------------------------------------+ | |
984263bc | 834 | |
a700883c SW |
835 | Instructions on how to obtain and maintain DragonFly source code using git |
836 | are in the development(7) manual page. | |
d2a0decc MD |
837 | |
838 | To upgrade a DragonFly system from sources you run the following sequence: | |
839 | ||
840 | cd /usr/src | |
841 | make buildworld | |
842 | make buildkernel KERNCONF=<KERNELNAME> | |
843 | make installkernel KERNCONF=<KERNELNAME> | |
844 | make installworld | |
845 | ||
846 | You will also want to run the 'upgrade' target to upgrade your /etc and the | |
847 | rest of your system. The upgrade target is aware of stale files created by | |
848 | older DragonFly installations and should delete them automatically. | |
849 | ||
850 | make upgrade | |
851 | ||
a700883c SW |
852 | See the build(7) manual page for further information. |
853 | ||
d2a0decc MD |
854 | Once you've done a full build of the world and kernel you can do incremental |
855 | upgrades of either by using the 'quickworld' and 'quickkernel' targets | |
856 | instead of 'buildworld' and 'buildkernel'. If you have any problems with | |
a700883c | 857 | the quick targets, try updating your repo first, and then a full buildworld |
d2a0decc | 858 | and buildkernel as shown above, before asking for help. |
4523a2c0 TN |
859 | |
860 | +-----------------------------------------------------------------------+ | |
861 | + UPGRADING FROM DRAGONFLY <= 2.0 TO DRAGONFLY >= 2.1 + | |
862 | +-----------------------------------------------------------------------+ | |
863 | ||
864 | In 2.1 kernel and modules has moved to boot directory. For most cases | |
865 | this is handled automatically by 'make upgrade'. A few cases needs manual | |
866 | intervention: | |
867 | ||
868 | * When installing a kernel without first doing a make buildworld, | |
869 | installworld and upgrade to the same DESTDIR as kernel: | |
870 | make DESTDIR/boot directory and move kernel and modules into this boot | |
871 | directory; also move kernel.old and modules.old. | |
872 | Typical example is vkernel(7), use (no modules used): | |
873 | ||
874 | cd /var/vkernel | |
875 | mkdir boot | |
876 | chflags noschg kernel | |
877 | mv kernel kernel.old boot | |
878 | chflags schg boot/kernel | |
879 | ||
880 | * When using a boot-only partition, /boot/loader.rc needs to be edited: | |
881 | delete occurrences of '/boot/'. | |
bbb35c81 | 882 | These occurrences can normally be deleted in any case, see loader(8). |
d2a0decc MD |
883 | |
884 | +-----------------------------------------------------------------------+ | |
885 | + UPGRADING FROM DRAGONFLY <= 1.8 TO DRAGONFLY >= 1.9 + | |
886 | +-----------------------------------------------------------------------+ | |
887 | ||
888 | In 1.9 major changes to the disk management infrastructure have taken | |
889 | place. make upgrade may not catch all of your disk devices in /dev, | |
890 | so after upgrading be sure to cd /dev; ./MAKEDEV <blah> where <blah> | |
45e80934 MD |
891 | are all of your disk devices. HOWEVER, from late 2.3 on we run devfs |
892 | and MAKEDEV no longer exists. | |
d2a0decc MD |
893 | |
894 | The biggest changes in 1.9 are: | |
895 | ||
896 | (1) That whole-slice devices such as da0s1 no longer share the same device | |
897 | id as partition c devices such as da0s1c. | |
898 | ||
899 | (2) The whole-disk device (e.g. da0) is full raw access to the disk, | |
900 | with no snooping or reserved sectors. Consequently you cannot run | |
901 | disklabel on this device. Instead you must run disklabel on a | |
902 | whole-slice device. | |
903 | ||
904 | (3) The 'compatibility' partitions now use slice 0 in the device name, | |
905 | so instead of da0a you must specify da0s0a. Also, as per (1) above, | |
906 | accessing the disklabel for the compatibility partitions must be | |
907 | done via slice 0 (da0s0). | |
908 | ||
909 | (4) Many device drivers that used to fake up labels, such as CD, ACD, VN, | |
910 | and CCD now run through the disk management layer and are assigned | |
911 | real disk management devices. VN and CCD in particular do not usually | |
912 | use a MBR and disklabels must be accessed through the compatibility | |
913 | slice 0. Your /etc/ccd.conf file still specifies 'ccd0', though, you | |
914 | don't name it 'ccd0s0' in the config file. | |
915 | ||
916 | Generally speaking, you have to get used to running fdisk and disklabel on | |
917 | the correctly specified device names. A lot of the wiggle, such as running | |
918 | disklabel on a partition, has been removed. | |
919 | ||
920 | +-----------------------------------------------------------------------+ | |
921 | + UPGRADING FROM OLDER VERSIONS OF DRAGONFLY OR FREEBSD + | |
922 | +-----------------------------------------------------------------------+ | |
923 | ||
924 | > Kerberos IV | |
925 | ------------- | |
926 | ||
927 | Kerberos IV (eBones) was removed from the tree, please consider moving to | |
928 | Kerberos 5 (Heimdal). | |
929 | ||
930 | > Package Management System | |
931 | --------------------------- | |
932 | ||
933 | Starting with the 1.4 release, DragonFly uses NetBSD's pkgsrc package | |
934 | management system. The necessary tools to build and maintain packages | |
935 | are provided in /usr/pkg/bin and /usr/pkg/sbin. Make sure that these | |
936 | directories are in your PATH variable. | |
937 | ||
938 | In order to obtain a reasonably current snapshot of the pkgsrc tree, use | |
939 | the tarball from NetBSD: | |
940 | ||
941 | fetch -o /tmp/pkgsrc.tar.gz ftp://ftp.NetBSD.org/pub/NetBSD/packages/pkgsrc.tar.gz | |
942 | cd /usr; tar -xzf /tmp/pkgsrc.tar.gz; chown -R root:wheel pkgsrc | |
943 | ||
944 | This tree can then be kept up to date with cvs update: | |
945 | ||
946 | cd /usr/pkgsrc; cvs up | |
947 | ||
948 | NOTE! If you upgraded from a pre-1.4 system to 1.4 or later, you need to | |
949 | build and install the pkgsrc bootstrap manually: | |
950 | ||
951 | cd /usr/pkgsrc/bootstrap | |
952 | ./bootstrap --pkgdbdir /var/db/pkg --prefix /usr/pkg | |
953 | ||
954 | +-----------------------------------------------------------------------+ | |
955 | + UPGRADING DRAGONFLY ON AN EXISTING DRAGONFLY SYSTEM + | |
956 | + UPDATING FROM PRE-1.2 SYSTEMS OR FreeBSD 4.x TO + | |
957 | + DRAGONFLY 1.3+ (EITHER PREVIEW or HEAD) + | |
958 | +-----------------------------------------------------------------------+ | |
58116288 | 959 | |
114580ac | 960 | The compatibility shims for the build environment have been removed, you |
58116288 JS |
961 | have to update to DragonFly 1.2 release branch first. |
962 | ||
1fcc7462 JS |
963 | The default PAM configuration has moved from /etc/pam.conf to /etc/pam.d/. |
964 | The existing configuration can be converted using /etc/pam.d/convert.sh. | |
965 | Entries in /etc/pam.d/ override entries in /etc/pam.conf. In addition | |
966 | the pam_skey.so module was retired, you have to remove it manually from | |
967 | your configuration, when you convert it. | |
58116288 | 968 | |
a3107071 MD |
969 | > Required user and group IDs when upgrading from either FreeBSD or DragonFly |
970 | --------------------- | |
971 | ||
972 | The following users may be missing from your password file. Use vipw and | |
973 | add any that are missing: | |
974 | ||
975 | smmsp:*:25:25::0:0:Sendmail Submission User:/var/spool/clientmqueue:/sbin/nologin | |
dcf85892 | 976 | _pflogd:*:64:64::0:0:pflogd privsep user:/var/empty:/sbin/nologin |
a3107071 MD |
977 | |
978 | The following groups may be missing from your group file. Use vi /etc/group | |
979 | and add any that are missing: | |
980 | ||
981 | smmsp:*:25: | |
982 | authpf:*:63: | |
dcf85892 | 983 | _pflogd:*:64: |
a3107071 MD |
984 | |
985 | ||
f419daca | 986 | > Upgrading to DragonFly from FreeBSD |
5e0ae0d4 | 987 | --------------------- |
984263bc | 988 | |
f419daca MD |
989 | You can build the DragonFly world and DragonFly kernels on a FreeBSD-4.x or |
990 | FreeBSD-5.x machine and then install DragonFly over FreeBSD, replacing | |
991 | FreeBSD. Note that the DragonFly buildworld target does not try to reuse | |
992 | make depend information, it starts from scratch, so no pre-cleaning of the | |
993 | object hierarchy is necessary. | |
994 | ||
466bbc10 | 995 | # get the CVS repository (it is placed in /home/dcvs, 500MB). |
f419daca MD |
996 | # Please use the -h option and a mirror site to pull the |
997 | # initial repository, but feel free to use the main repository | |
998 | # machine to pull updates. | |
5010eeb3 | 999 | cvsup /usr/share/examples/cvsup/DragonFly-cvs-supfile |
f419daca MD |
1000 | # install the source from the CVS hierarchy (remove preexisting |
1001 | # FreeBSD src first) (500MB) | |
1002 | cd /usr | |
1003 | rm -rf src | |
50172b1c | 1004 | cvs -R -d /home/dcvs checkout -P src |
f419daca MD |
1005 | |
1006 | # build it (500MB used in /usr/obj) | |
1007 | # | |
1008 | cd /usr/src | |
1009 | make buildworld | |
1010 | make buildkernel KERNCONF=<KERNELNAME> | |
984263bc | 1011 | |
f419daca MD |
1012 | Once you have built DragonFly you have to install it over FreeBSD. Since |
1013 | DragonFly does not track changes made by FreeBSD to its include file | |
1014 | hierarchy and include file pollution can cause all sorts of unexpected | |
1015 | compilation issues to come up, it is best to wipe your include hierarchy | |
1016 | prior to installing DragonFly. Note that you should not wipe any installed | |
1017 | FreeBSD header files or binaries until after you have successfully completed | |
1018 | the build steps above. | |
fb12f484 | 1019 | |
f419daca MD |
1020 | rm -rf /usr/include |
1021 | mkdir /usr/include | |
1022 | make installkernel KERNCONF=<KERNELNAME> | |
1023 | make installworld | |
fb12f484 | 1024 | |
b8cbf045 | 1025 | Then you need to upgrade your system. DragonFly's 'make upgrade' target |
f419daca | 1026 | will unconditionally upgrade the /etc files that sysops do not usually |
b8cbf045 SW |
1027 | mess around with, such as the files in /etc/rc.d. It will also remove any |
1028 | obsolete files such as utilities and manpages that have been removed from | |
1029 | the system since the version you're coming from. If you are unsure we | |
1030 | recommend that you make a backup of at least your /etc before applying | |
1031 | this step. Note that DragonFly's RC system is basically RCNG from | |
1032 | FreeBSD-5, but there are some differences in the contents of the RC files. | |
f419daca MD |
1033 | |
1034 | make upgrade | |
1035 | ||
b8cbf045 SW |
1036 | NOTE! Never do a 'make upgrade' before 'make installworld' has been run. |
1037 | Doing so might leave your system in an unusable state. | |
1038 | ||
f419daca | 1039 | Finally we recommend that you do an 'ls -lta BLAH' for /bin, /sbin, /usr/bin, |
b8cbf045 SW |
1040 | /usr/bin, and /usr/lib, and remove any stale files that you find. Please |
1041 | report these files to the DragonFly developers so that they can be added to | |
1042 | the 'upgrade' target. | |
f419daca | 1043 |