1 This file documents some of the problems you may encounter when upgrading
2 your ports. We try our best to minimize these disruptions, but sometimes
5 You should get into the habit of checking this file for changes each time
6 you update your ports collection, before attempting any port upgrades.
9 AFFECTS: users of mail/nextcloud-mail
10 AUTHOR: brnrd@FreeBSD.org
12 Version 0.20.0 removed the default mail configuration via config.php.
13 All users will be prompted to enter account and SMTP- and IMAP-server
14 details for sending and reading email.
17 AFFECTS: consumers of net/py-urllib3
18 AUTHOR: kai@FreeBSD.org
20 Since version 1.25 HTTPS connections are now verified by default which is
21 done via "cert_reqs = 'CERT_REQUIRED'". While certificate verification
22 can be disabled via "cert_reqs = 'CERT_NONE'", it's highly recommended to
25 Various consumers of net/py-urllib3 already have implemented routines that
26 either explicitly enable or disable HTTPS certificate verification (e.g.
27 via configuration settings, CLI arguments, etc.).
29 Yet it may happen that there are still some consumers which don't
30 explicitly enable/disable certificate verification for HTTPS connections
31 which could then lead to errors (as is often the case with self-signed
34 In case of an error one should try first to temporarily disable
35 certificate verification of the problematic urllib3 consumer to see if
36 this approach will remedy the issue.
39 AFFECTS: users of emulators/qemu
40 AUTHOR: bofh@FreeBSD.org
42 emulators/qemu31 has been updated to 4.1.1. Previous 3.1.X branch has
43 been repocopied to emulators/qemu31. If someone wants to stick with 3.1.X
44 branch please use one of the following command:
46 # pkg install emulators/qemu31
48 # portmaster -o emulators/qemu31 emulators/qemu
50 # portupgrade -o emulators/qemu31 emulators/qemu
53 AFFECTS: users of irc/eggdrop
54 AUTHOR: dbaio@FreeBSD.org
56 The irc/eggdrop port has been updated to 1.8.4 and its config is not
57 backward compatible with 1.6.21. A new port was created to keep 1.6.21
58 version available at irc/eggdrop16 and it will be available for 3 months
59 until users have time to upgrade their configuration.
62 https://raw.githubusercontent.com/eggheads/eggdrop/v1.8.4/NEWS
64 If you would like to keep using 1.6.21, please run the following command
65 to update pkg database:
67 pkg set -n eggdrop:eggdrop16
68 pkg set -o irc/eggdrop:irc/eggdrop16
71 AFFECTS: users of databases/redis[-devel]
72 AUTHOR: osa@FreeBSD.org
74 The databases/redis port has been updated to the recent stable release.
75 Users wanting to stay on v4.x can replace databases/redis with
76 databases/redis4 with one of the following commands:
78 # pkg install databases/redis4
80 # portmaster -o databases/redis4 databases/redis
82 # portupgrade -o databases/redis4 databases/redis
85 AFFECTS: users of www/node
86 AUTHOR: bhughes@FreeBSD.org
88 The www/node port has been updated to Node.js v13.0.0, the latest
89 upstream release. A new port, www/node12, has been created for the
90 v12.x LTS branch. Users wanting to stay on v12.x can replace www/node
91 with www/node12 with one of the following commands:
93 # pkg install www/node12
95 # portmaster -o www/node12 www/node
97 # portupgrade -o www/node12 www/node
100 AFFECTS: users of emulators/open-vm-tools[-nox11]
101 AUTHOR: jpaetzel@FreeBSD.org
103 open-vm-tools 11.0.1 has removed the vmxnet driver. This driver has been
104 in tree for quite some time and hopefully everyone is using the in tree
105 version, however if you had removed device vmx from your kernel, or are
106 running an unsupported version of FreeBSD which didn't have the driver
107 included in the base system, updating your open-vm-tools version will
108 leave you without networking.
111 AFFECTS: users of www/qt5-webengine
112 AUTHOR: kai@FreeBSD.org
114 Users that upgrade www/qt5-webengine without using pkg/poudriere might
115 experience failures due to conflicts with the installed version of 5.12.2.
117 In that case, pkg delete -f the qt5-webengine package before building
121 AFFECTS: users of x11/nvidia-driver (and slave ports)
122 AUTHOR: danfe@FreeBSD.org
124 x11/nvidia-driver* ports no longer install Linux programs and libraries,
125 which had been moved to their own ports (x11/linux-nvidia-libs*). When
126 updating the driver package next time, remember to install them manually
127 if you need to run Linux OpenGL programs.
130 AFFECTS: users of KDE Plasma Desktop (x11/plasma5*)
131 AUTHOR: kde@FreeBSD.org
133 With Plasma 5.17 the startup script has been renamed. People who use the
134 .xinitrc method to start Plasma have to call the new binary.
137 exec ck-launch-session startkde
139 exec ck-launch-session startplasma-x11
142 AFFECTS: users of mail/rspamd, mail/rspamd-devel
143 AUTHOR: vsevolod@FreeBSD.org
145 Sample configuration files has been removed as default configuration files
146 are NOT intended for modification by users and SHOULD be overwritten on
149 Make sure the default configuration files are unmodified and migrate all
150 configuration changes to the proper places, before you continue.
153 AFFECTS: users of textproc/groff
154 AUTHOR: bapt@FreeBSD.org
156 with groff 1.2.4_3, groff does not depend anymore on ghostscript and
157 netpbm. In order to be able to properly use the html backend the user
158 can install ghostscript and netpbm from ports without the need of
159 reinstalling the package.
161 Also note that the X11 option has been removed.
164 AFFECTS: users of net-mgmt/netbox
165 AUTHOR: kai@FreeBSD.org
167 Since the 2.6 release a running Redis server instance is required for
168 caching objects to run. Also the following settings like below need to be
169 added (or modified) in the existing configuration.py:
177 'DEFAULT_TIMEOUT': 300,
181 Note that if you were using these settings in a prior release with
182 webhooks, the DATABASE setting remains the same but an additional
183 CACHE_DATABASE settings has been added with a default value of 1 to
184 support the caching backend.
186 The DATABASE setting will be renamed in a future release of NetBox to
187 better relay the meaning of the setting. It is highly recommended to keep
188 the webhook and cache databases separate. Using the same database number
189 for both may result in webhook processing data being lost during cache
192 Please also check the pkg-message and the changelogs for further info.
195 AFFECTS: users of emulators/qemu-devel
196 AUTHOR: bofh@FreeBSD.org
198 qemu-devel has been updated to 4.1.0 and 4.0.0 has been merged into a new port
199 emulators/qemu40. If you want to stick with 4.0.X branch, simply use:
200 # portmaster -o emulators/qemu-devel emulators/qemu40
203 AFFECTS: users of XFCE desktop (x11-wm/xfce4)
204 AUTHOR: madpilot@FreeBSD.org
206 Due to changes in the XFCE 4.14 metaport, systems could end up with
207 both xscreensaver and xfce4-screensaver installed and enabled
210 This can cause conflicts and problems unlocking the screen.
212 To avoid problems, please make sure to have only one enabled by
213 going to the Application Autostart tab of the Session and Startup
214 settings applet and enable only one Screensaver there.
216 Some further information can be found in the xfce4-session
217 pkg-message displayed on installation and upgrade.
220 AFFECTS: users of net-mgmt/pushgateway
221 AUTHOR: 0mp@FreeBSD.org
223 The persistent storage format used by pushgateway in the latest version
224 is not backwards compatible. See the pushgateway changelogs for details.
227 AFFECTS: users of security/bastillion
228 AUTHOR: netchild@FreeBSD.org
230 The datastore of bastillion needs to be updated:
231 java -jar $PREFIX/jetty_bastillion/upgrade/bastillion-upgrade-3.08.00.jar \
232 $PREFIX/jetty_bastillion/bastillion/WEB-INF/classes/BastillionConfig.properties
235 AFFECTS: users of lang/ruby25
236 AUTHOR: mfechner@FreeBSD.org
238 The default ruby version has been updated from 2.5 to 2.6.
240 If you compile your own ports you may keep 2.5 as the default version by
241 adding the following lines to your /etc/make.conf file:
244 # Keep ruby 2.5 as default version
246 DEFAULT_VERSIONS+=ruby=2.5
248 If you wish to update to the new default version, you need to first stop any
249 software that uses ruby. Then, you will need to follow these steps, depending
250 upon how you manage your system.
252 If you use pkgng, simply upgrade:
255 If you do not use pkg, please check entry 20190420.
256 The description there should also work for this version.
259 AFFECTS: users of devel/py-fabric
260 AUTHOR: dbaio@FreeBSD.org
262 Fabric (devel/py-fabric) was upgraded to 2.5.0, Fabric (2+) represents
263 a near-total reimplementation and reorganization of the software.
265 Fabric 2 is not at 100% feature parity with 1.x! Some features have been
266 explicitly dropped, but others simply have not been ported over yet,
267 either due to time constraints or because said features need to be
268 re-examined in a modern context.
271 https://www.fabfile.org/upgrading.html#upgrading
272 https://www.fabfile.org/upgrading.html#upgrade-specifics
274 If you would like to keep using 1.x, please run the following command to
277 pkg set -n py27-fabric:py27-fabric1
278 pkg set -o devel/py-fabric:devel/py-fabric1
281 AFFECTS: users of www/gitlab-ce
282 AUTHOR: mfechner@FreeBSD.org
284 Make sure you upgrade your PostgreSQL to version 11 as described in 20190829,
285 before you upgrade your gitlab-ce version.
286 Gitlab-ce 12.1 needs at least PostgreSQL version 9.6.
288 After this you can follow the usual upgrade guide:
289 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/12.0-12.1-freebsd.md
292 AFFECTS: users of database/postgresql* and other software using PostgreSQL to run
293 AUTHOR: tz@FreeBSD.org
295 The default version of PostgreSQL has been switched from 9.5 to 11.
296 The upgrade procedure can use up twice the space the databases
297 currently needs. If you have a big amount of stored data take a
298 closer look at the manpage of pg_upgrade for avoidance and/or
299 speedup of the upgrade.
301 The upgrade instructions consider a basic usage and do not match
302 complex scenarios like replication, sharding, or similar.
304 Upgrade instructions:
306 First stop your PostgreSQL, create PostgreSQL-binaries and backup your data.
307 If you have another Version of PostgreSQL installed, for example 9.5.19, your
308 files are named according to this.
310 # service postgresql stop
311 # pkg create postgresql95-server postgresql95-contrib
312 # mkdir /tmp/pg-upgrade
313 # tar xf postgresql95-server-9.5.19.txz -C /tmp/pg-upgrade
314 # tar xf postgresql95-contrib-9.5.19.txz -C /tmp/pg-upgrade
315 # pkg delete -f databases/postgresql95-server databases/postgresql95-contrib databases/postgresql95-client
317 Now update PostgreSQL:
320 # pkg install databases/postgresql11-server databases/postgresql11-contrib
324 # portmaster databases/postgresql11-server databases/postgresql11-contrib
328 # portinstall databases/postgresql11-server databases/postgresql11-contrib
331 After installing the new PostgreSQL version you need to convert
332 all your databases to new version:
334 # su -l postgres -c "/usr/local/bin/initdb --encoding=utf-8 --lc-collate=C -D /var/db/postgres/data11 -U pgsql"
335 # chown -R postgres /usr/local/pgsql/data/
336 # su -l postgres -c "pg_upgrade -b /tmp/pg-upgrade/usr/local/bin/ -d /usr/local/pgsql/data/ -B /usr/local/bin/ -D /var/db/postgres/data11/ -U pgsql "
338 Now the migration is finished. You can start PostgreSQL again with:
340 # service postgresql start
343 1) The default user changed from "pgsql" to "postgres". The migration steps above preserve
344 the "pgsql" database user while the database daemon is now executed as the "postgres" FreeBSD user.
345 2) The default data dir changed from "/usr/local/pgsql/data/" to "/var/db/postgres/data11/"
346 3) If you use non-default initdb options, you have to adjust the initdb-command accordingly
349 AFFECTS: users of net-im/ejabberd
350 AUTHOR: ashish@FreeBSD.org
352 Riak support has been removed by upstream. For update instructions from
353 19.05, please refer to:
355 https://docs.ejabberd.im/admin/upgrade/from_19.05_to_19.08/
358 AFFECTS: users of lang/perl5*
359 AUTHOR: mat@FreeBSD.org
361 The default Perl version has been switched to Perl 5.30. If you are using
362 binary packages to upgrade your system, you do not have anything to do, pkg
363 upgrade will do the right thing. For the other people, follow the
364 instructions in entry 20161103, it should still be the same.
367 AFFECTS: users of www/ot-recorder
368 AUTHOR: dvl@FreeBSD.org
370 The data directory has moved from /var/spool/owntracks to
373 Be sure to stop otrecorder, move the directory, and start otrecorder.
375 service ot-recorder stop
378 service ot-recorder start
381 AFFECTS: users of net-im/py-matrix-synapse
382 AUTHOR: kai@FreeBSD.org
384 The support for Python 2.7 has been dropped with the 1.1.0 release of
385 net/py-matrix-synapse.
387 Users that still use the Python 2.7 version of net-im/py-matrix-synapse
388 should switch to a newer Python version, e.g. 3.6, which is the default
389 Python version since April 2019.
392 AFFECTS: users of net-p2p/zetacoin and net-p2p/zetacoin-nox11
393 AUTHOR: daniel@morante.net
395 Zetacoin will default to using modern versions of BDB (5.x or 6.x) when
396 the WALLET option is selected. See pkg-help for explanation.
398 The zetacoin-nox11 slave port was renamed to zetacoin-daemon to align
399 with the net-p2p/bitcoin format.
401 The zetacoin-cli and zetacoin-tx utilities have been re-packaged into
402 a separate port. If you require these programs, or use the zetacoin-cli
403 program to access the daemon or the GUI, install net-p2p/zetacoin-utils
407 AFFECTS: users of sysutils/py-borgmatic
408 AUTHOR: egypcio@FreeBSD.org
410 The default location for borgmatic's configurations changed. We moved it
411 from '/etc/borgmatic' to '/usr/local/etc/borgmatic' in order to follow
412 recommended standards used on FreeBSD.
415 AFFECTS: users with DEFAULT_VERSIONS+=linux=c6 or c6_64 in /etc/make.conf
416 AUTHOR: tijl@FreeBSD.org
418 On amd64 adding DEFAULT_VERSIONS+=linux=c6 to /etc/make.conf made Linux
419 infrastructure ports (linux_base-c6 and linux-c6*) install i386 CentOS 6
420 packages. Using c6_64 instead of c6 made them install mixed amd64/i386
421 CentOS 6 packages and allowed Linux application ports to install amd64
422 binaries when available. The i386-only configuration was only useful for
423 users of x11/nvidia-driver* which didn't provide Linux amd64 emulation
426 With x11/nvidia-driver* now supporting Linux amd64 there's no longer a
427 need for i386-only Linux on amd64 so DEFAULT_VERSIONS+=linux=c6 has been
428 changed to make Linux infrastructure ports install mixed amd64/i386
429 CentOS 6 packages, like c6_64 before, and support for c6_64 has been
432 Users with DEFAULT_VERSIONS+=linux=c6 should reinstall linux_base-c6 and
433 all packages that depend on it. A list of dependent packages can be
434 obtained with the following command:
436 pkg info -r linux_base-c6
438 Users with DEFAULT_VERSIONS+=linux=c6_64 only need to replace c6_64 with
439 c6 in /etc/make.conf.
441 Users of x11/nvidia-driver* should upgrade to FreeBSD 11.3 or 12.0 if
442 they want to run Linux amd64 OpenGL programs. If you are running an
443 older version you may want to postpone installing or updating Linux
444 application ports until you find the time to upgrade because application
445 ports may install amd64 binaries now. Infrastructure ports are safe to
446 reinstall, and so is x11/nvidia-driver*.
448 On i386 nothing has changed.
451 AFFECTS: users of www/gitlab-ce
452 AUTHOR: mfechner@FreeBSD.org
454 You must at first upgrade to version 11.11.5 before you can upgrade
456 Support for MySQL will be dropped with next version.
457 Make sure you use at least PostgreSQL version 9.6.
458 Follow the normal upgrade manual that can be found here:
459 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/11.11-12.0-freebsd.md
462 AFFECTS: users of net/serviio which bought a license for the non-free features
463 AUTHOR: netchild@FreeBSD.org
465 Version 2 of serviio needs a new license file. Updating without a new license
466 file will disable the non-free features.
469 AFFECTS: users of databases/mysql56-(server|client)
470 AUTHOR: ale@FreeBSD.org
472 The default MySQL version has been updated from 5.6 to 5.7.
474 If you compile your own ports you may keep 5.6 as the default version by
475 adding the following lines to your /etc/make.conf file:
478 # Keep MySQL 5.6 as default version
480 DEFAULT_VERSIONS+=mysql=5.6
482 If you wish to update to the new default version, you need to first stop any
483 running server instance. Then, you will need to follow these steps, depending
484 on installed packages.
486 # pkg set -o databases/mysql56-client:databases/mysql57-client
487 # pkg set -o databases/mysql56-server:databases/mysql57-server
491 AFFECTS: users of net/samba410
492 AUTHOR: timur@FreeBSD.org
494 If you used Samba in AD/DC mode with the previous versions of the port on UFS2
495 backed storage you have to add usage of vfs_freebsd VFS module for at least
496 SYSVOL share and configure it to use 'legacy' mode(see manpage).
498 The reason behind this is that previous versions Samba port used a hack to
499 workaround broken mapping of Linux security and trusted extended attributes
500 into FreeBSD namespace. In particular, essential security.NTACL attribute
501 was replaced with the user.NTACL and placed in a insecure USER namespace.
503 This port dropped this hack in favor of vfs_freebsd module, which should
504 provide more controlled way of such a mapping.
506 To maintain the compatibility with the previous installations on UFS2 storage
507 (as ZFS uses it's own way of mapping SYSVOL, thanks to the iXsystems patches)
508 the vfs_freebsd module provides 'legacy' mode that implements old functionality.
510 For the fresh installations it is recommended to use 'secure' mode of operations
511 for this module and use it as a global vfs objects.
513 Caution: The given module is still considered EXPERIMENTAL.
516 AFFECTS: users of net/samba410, net/samba4[6-8] and devel/talloc?, devel/tevent?, databases/tdb?, databases/ldb*
517 AUTHOR: timur@FreeBSD.org
519 The port of the new version of Samba 4.10 is introduced. Due necessarily
520 to keep backwards compatibility for the legacy samba4[6-8] ports the
521 upgrade procedure is a bit convoluted.
523 You are safe to perform fresh new install of samba410 port. In case you
524 are upgrading from the previous versions of Samba, please use the
527 0. Take backups of all the relevant files, in particular PREFIX/etc/smb4.conf
528 and /var/db/samba4/ subdirectory. Keep in mind that files there (may)
529 have extended attributes, so use appropriate tools to preserve them.
531 1a. If you haven't updated Samba between 20190619 and 20190630 then next
532 step should be as simple as:
534 portmaster -o net/samba410 net/samba48
536 1b. If you have been affected by the archiving legacy versions of
537 Samba-related libraries for legacy versions of Samba, which happened
538 in the given time frame, then you need to reverse operation from the
541 for users of portmaster:
542 portmaster -o devel/talloc devel/talloc1
543 portmaster -o devel/tevent devel/tevent1
544 portmaster -o databases/tdb databases/tdb1
545 portmaster -o net/samba410 net/samba48
547 for users of portupgrade:
548 portupgrade -o devel/talloc devel/talloc1
549 portupgrade -o devel/tevent devel/tevent1
550 portupgrade -o databases/tdb databases/tdb1
551 portupgrade -o net/samba410 net/samba48
554 AFFECTS: users of samba4[6-8] and devel/talloc, devel/tevent, databases/tdb, databases/ldb*
555 AUTHOR: timur@FreeBSD.org
557 To introduce samba410(we deliberately skip samba49 due the complexity of handling)
558 and to drop dependency on deprecated Python 2.7, Samba supplementary libraries
559 talloc, tevent and tdb were split into current Python 3 compatible versions
560 and legacy ones, with the suffix "1".
562 Old versions of Samba were changed to depend on the legacy supplementary libraries,
563 so if you need to install samba46, samba47 or samba48 over previous Samba
564 installations you need to downgrade supplementary libs with the following commands:
566 for users of portmaster:
567 portmaster -o devel/talloc1 devel/talloc
568 portmaster -o devel/tevent1 devel/tevent
569 portmaster -o databases/tdb1 databases/tdb
570 portmaster -r talloc1
572 for users of portupgrade:
573 portupgrade -o devel/talloc1 devel/talloc
574 portupgrade -o devel/tevent1 devel/tevent
575 portupgrade -o databases/tdb1 databases/tdb
576 portupgrade -fr devel/talloc1
579 AFFECTS: users of www/qt5-webengine
580 AUTHOR: kai@FreeBSD.org
582 Users that upgrade www/qt5-webengine without using pkg/poudriere might
583 experience failures due to conflicts with the installed version of 5.12.2.
585 In that case, pkg delete -f the qt5-webengine package before building
589 AFFECTS: users of net/routinator
590 AUTHOR: rodrigo@FreeBSD.org
592 Release 0.4.0 fundamentally changes the command line options for
593 running the server and introduces a new way to initialize the local RPKI
594 repository used by Routinator.
595 If you have been using previous releases, you will likely have to adjust
596 your tooling. We apologize for this, but we also feel that the new commands
597 are more intuitive and logical.
600 AFFECTS: users of net/samba47
601 AUTHOR: antoine@FreeBSD.org
603 The default version of samba has been switched from 4.7 to 4.8.
604 Upgrade instructions:
606 For package users having samba47 installed indirectly (as a dependency):
609 For package users having samba47 installed directly (leaf port):
611 # pkg install samba48
614 If you want to keep samba47, add DEFAULT_VERSIONS+= samba=4.7 to make.conf
616 If you want to upgrade to samba48, remove samba47:
617 # pkg delete -f samba47
620 # portmaster net/samba48
624 # portinstall net/samba48