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.
10 AFFECTS: users of editors/libreoffice
11 AUTHOR: fluffy@FreeBSD.org
13 LibreOffice was updated to 6.4 branch with some critical changes:
14 - GTK2 option is obsolete by upstream
15 - GTK3 option is not more set by default because of unstable yet and have visual glitches
16 - QT5 option is set by default to provide comfy visual style for every user
17 - KDE option was renamed to KF5 follows upstream
19 Please re-run "make config" to pick up the new defaults
22 AFFECTS: users of www/node
23 AUTHOR: bhughes@FreeBSD.org
25 The www/node port has been updated to Node.js v14.0.0, the latest
26 upstream release. This is a major release, including many significant
27 changes. Users are encouraged to read the release announcements before
30 https://nodejs.org/en/blog/release/v14.0.0/
33 AFFECTS: users of www/radicale
34 AUTHOR: decke@FreeBSD.org
36 Migration from radicale 1.x to 2.x requires that you export the storage
37 with radicale 1.1.6 before updating.
39 Migration instructions are available at:
40 https://web.archive.org/web/20190314225402/https://radicale.org/1to2/
43 AFFECTS: users of sysutils/py-salt
44 AUTHOR: krion@FreeBSD.org
46 This port is moved to sysutils/py-salt-2019 and sysutils/py-salt was
47 updated to version 3000.
49 If you wish to use pysalt-2019 in the future, you might run the
52 # pkg set -o sysutils/py-salt:sysutils/py-salt-2019
56 AFFECTS: users of mail/postfix-policyd-spf-python
57 AUTHOR: yasu@utahime.org
59 This port is now deprecated because upstream project is superseded by its
60 successor. So uninstall this port and install mail/py-spf-engine instead.
61 Keep in mind that the path of configuration file is changed from
62 ${PREFIX}/etc/postfix-policyd-spf-python/policyd-spf.conf to
63 ${PREFIX}/etc/python-policyd-spf/policyd-spf.conf. So you need to move
64 it to new location unless you use the default one without changing.
67 AFFECTS: users of databases/mariadb104-client, databases/mariadb104-server
68 AUTHOR: brnrd@FreeBSD.org
70 The ports now add sample configuration files to /usr/local/etc/mysql. You
71 must merge your client configation with the conf.d/client.cnf and your
72 server configuration with conf.d/server.cnf.
75 AFFECTS: users of converters/libiconv
76 AUTHOR: zeising@FreeBSD.org
78 Support for the Japanese specific patches have been discontinued.
79 These were previously added in a nondefault ports options, for people who
81 If you still need them, it might be possible to create a port of libiconv 1.14
82 which includes those patches.
85 AFFECTS: users of x11/sddm
86 AUTHOR: arrowd@FreeBSD.org
88 The home directory of sddm user has been moved to /var/lib/sddm. It is advised
89 to run following commands as root after updating the package:
91 # pw usermod -n sddm -d /var/lib/sddm
92 # pwd_mkdb /etc/master.passwd
93 # mv /usr/local/etc/sddm/home/state.conf /var/lib/sddm/state.conf
94 # rm -rf /usr/local/etc/sddm/home
96 Otherwise, SDDM will keep using /usr/local/etc/sddm/home/ as its HOME.
99 AFFECTS: users of devel/libphutil, devel/arcanist-lib, devel/phabricator
100 AUTHOR: grembo@FreeBSD.org
102 Upstream fully deprecated devel/libphutil and merged its functionality
103 into devel/arcanist-lib and devel/phabricator. As a result, the
104 devel/libphutil port will be removed from the ports tree.
106 After upgrading devel/(arcanist-lib|phabricator) to version 20200514, it is
107 recommended to remove the orphaned libphutil package by running:
109 # pkg delete php\*-libphutil
111 Alternatively, 'pkg autoremove' will also work as expected, but might
112 remove orphaned packages unrelated to this update.
115 AFFECTS: users of net-im/pidgin-rocketchat
116 AUTHOR: tobias.rehbein@web.de
118 This port has been turned into a libpurple plugin (net-im/purple-rocketchat)
119 to support other libpurple clients than pidgin.
121 This also changes some dependencies and you should run the following command
122 to prevent pidgin from being autoremoved.
124 # mark pidgin as being not automatically installed
128 AFFECTS: users of x11-wm/hs-xmonad
129 AUTHOR: arrowd@FreeBSD.org
131 From now, it is recommended to use "build script" method to compile XMonad
132 config. See https://github.com/xmonad/xmonad-testing/ for general info and
133 port's pkg-message for concrete steps.
136 AFFECTS: users of net-mgmt/librenms
137 AUTHOR: dvl@FreeBSD.org
139 Polling via cronjob is deprecated as of release 1.63
140 see see https://community.librenms.org/t/dropping-support-for-php-7-1-and-python-2/11851
142 Please migrate to the Dispatch Service:
143 https://docs.librenms.org/Extensions/Dispatcher-Service/
145 These steps should get you running:
146 * comment out the crontab entries listed above under PYPOLLER
147 * populate %%WWWDIR%%/.env with:
148 * APP_KEY - see farther below for how to create
149 * NODE_ID - see just below for how to create
154 * you can create a NODE_ID with: php -r 'echo uniqid() . "\n";'
155 * sysrc librenms_enable="YES"
156 * service librenms start
159 AFFECTS: users of www/phpmyfaq
160 AUTHOR: flo@FreeBSD.org
162 phpMyFAQ has been updated to 3.0.2, old templates are not compatible with
163 this new version. Please see:
165 https://www.phpmyfaq.de/docs/3.0#3.4
168 AFFECTS: users of sysutils/ansible
169 AUTHOR: bofh@FreeBSD.org
171 Ansible has been updated to 2.9.7. Please follow the porting guide
172 to update the rulesets:
174 https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_2.9.html
176 If you wish to stay with 2.8 version, you can switch
177 to new sysutils/ansible28 port, which tracks stable 2.8 branch:
179 # pkg set -n ansible:ansible28
182 AFFECTS: x11-servers/xwayland-devel
183 AUTHOR: jbeich@FreeBSD.org
185 DRI3 is enabled by default since mesa-libs-18.3.2_4, so you no
186 longer need to define LIBGL_DRI3_ENABLE in ~/.profile or ~/.login.
188 See 20200308 entry for more details.
191 AFFECTS: users of devel/kyua
192 AUTHOR: brooks@FreeBSD.org
194 A tests group has been added and the tests user should be a member
195 of it by default rather than nobody. You should update your password
196 database to match (change the group from 65534 to 977 after updating).
198 Please use the following command to do so:
200 pw usermod -n tests -g tests
203 AFFECTS: users of security/openssh-portable
204 AUTHOR: bdrewery@FreeBSD.org
206 OpenSSH was upgraded to 8.2p1 on 2020-03-23.
208 A restart of sshd is required after upgrade due to an incompatibility
211 Please see https://www.openssh.com/txt/release-8.2 for upcoming
215 AFFECTS: users of net/irrd
216 AUTHOR: bofh@FreeBSD.org
218 Legacy version of net/irrd has been moved to net/irrd-legacy.
219 net/irrd has been upgraded to 4.X branch. If someone wants to stick with
220 legacy version then pkg users have to do something like
222 # pkg set -o net/irrd:net/irrd-legacy
225 # portmaster -o net/irrd-legacy net/irrd
227 Both of the version can be installed and used concurrently in case there is
231 AFFECTS: users of x11-fonts/fontconfig
232 AUTHOR: desktop@FreeBSD.org
234 Fontconfig 2.13.1 generated .uuid files in the fonts directory which where
235 not properly registered to the packages. To clean them up, please execute the
238 find /usr/local/share/fonts -type f -name .uuid -delete
241 AFFECTS: users of devel/sonarqube and devel/sonar-ant-task
242 AUTHOR: netchild@FreeBSD.org
244 The outdated port devel/sonarqube has moved to
245 devel/sonarqube-community to make it clear that it is the community
246 edition. The log and DB files are still stored in the same location.
248 The devel/sonar-ant-task port has moved to devel/sonarqube-ant-task
249 to match the upstream-name. The install location is renamed
252 At the same time the user/group of the sonarqube port changed from
253 www:www to sonarqube:sonarqube.
255 It is expected that nobody was using the 6.2 version from 2016
256 anymore and no change needs to be done. No analysis was done to check
257 if the old 6.2 version can be updated in-place to the 8.2 version.
258 As such if there is still someone using the old 6.2 version, you may
259 have to delete /var/log/sonarqube and /var/db/sonarqube before
260 installing the new version.
263 AFFECTS: users of devel/qca
264 AUTHOR: kde@FreeBSD.org
266 New versions of devel/qca stopped supporting OpenSSL < 1.1.
267 For this reason devel/qca-legacy has been added, which is
268 held back at an older version until FreeBSD 11 goes EOL.
270 Ports depending on devel/qca should stop adding direct LIB_DEPENDS
271 and switch to depending on it via USES=qca.
273 FreeBSD 11 users might want to run something like
275 pkg set -o devel/qca:devel/qca-legacy
278 AFFECTS: users of x11/libxkbcommon
279 AUTHOR: zeising@FreeBSD.org
281 The libxkbcommon library (x11/libxkbcommon), used to handle keyboards
282 in some applications, most notably kde and wayland, have been switched
283 to use evdev rules by default on FreeBSD 12 and later. Some keys, most
284 notably arrow keys, may not work in applications using libxkbcommon if
285 you are using xf86-input-keyboard rather than xf86-input-libinput.
286 If you have trouble with the keyboard keys, and if /var/log/Xorg.*.log
287 shows that the "kbd" or "keyboard" driver is being used, you need to
288 switch to legacy rules by setting the environment variable
289 XKB_DEFAULT_RULES to xorg.
290 This switch is made to match the default configuration on FreeBSD 12.1 and
291 later, the default configuration on FreeBSD 11.3 still uses the legacy
295 AFFECTS: users of net-im/slack-term
296 AUTHOR: dmgk@FreeBSD.org
298 The config file location was changed from ~/.slack-term to
299 ~/.config/slack-term/config, please move your existing config file
303 AFFECTS: users of graphics/mesa-libs and legacy graphics drivers
304 AUTHOR: zeising@FreeBSD.org
306 The mesa OpenGL library (graphics/mesa-libs) has been switched to use DRI3
307 by default, instead of the older DRI2 interface. This might cause regressions
308 when using the legacy graphics drivers, either through
309 graphics/drm-legacy-kmod or the graphics drivers in base.
311 If you experience issues when running OpenGL applications it is possible
312 to force the use of DRI2 by setting the LIBGL_DRI3_DISABLE environment
313 variable to 1 before starting any OpenGL application. The easiest way to
314 do this is by adding it to either your shell startup files or .xinitrc.
317 AFFECTS: users of databases/mysql80-server
318 AUTHOR: joneum@FreeBSD.org
320 As of MySQL 8.0.16, the MySQL server performs the upgrade tasks previously
321 handled by mysql_upgrade. Consequently, mysql_upgrade is unneeded and is
322 deprecated as of that version, and will be removed in a future MySQL version.
323 Because mysql_upgrade no longer performs upgrade tasks,
324 it exits with status 0 unconditionally.
327 AFFECTS: users of net-mgmt/librenms
328 AUTHOR: dvl@FreeBSD.org
330 1. Apache / mod_php options removed
332 The APACHEMOD option has been removed. LibreNMS can be used
333 with other webservers, not just Apache. In order to simplify
334 the port, the option was removed.
336 Now you manually install the webserver of your preference.
338 If upgrading from LibreNMS < 1.61, you can do this to
339 prevent 'pkg autoremove' from uninstalling Apache / mod_php:
341 $ sudo pkg set -A 0 apache24 mod_php74
342 Mark apache24-2.4.41 as not automatically installed? [y/N]: y
343 Mark mod_php74-7.4.3 as not automatically installed? [y/N]: y
345 Adjust mod_php74 to suit the version of mod_php you have.
347 2. include/defaults.inc.php is gone
349 The file include/defaults.inc.php is no longer distributed by
350 the upstream project. The FreeBSD port patched this file to
351 correct the paths to common tools such as ping, snmpwalk, etc.
353 These values previously adjusted by the port must now be specified
354 in config.php. New installs will have this automatically, but existing
355 installs must be updated manually. These are the entries you should
356 add if upgrading from LibreNMS < 1.61:
358 $config['snmpwalk'] = '/usr/local/bin/snmpwalk';
359 $config['snmpget'] = '/usr/local/bin/snmpget';
360 $config['snmpbulkwalk'] = '/usr/local/bin/snmpbulkwalk';
361 $config['snmptranslate'] = '/usr/local/bin/snmptranslate';
363 $config['ping'] = '/sbin/ping';
364 $config['mtr'] = '/usr/local/bin/mtr';
365 $config['nmap'] = '/usr/local/bin/nmap';
367 $config['nagios_plugins'] = '/usr/local/libexec/nagios';
368 $config['ipmitool'] = '/usr/local/bin/ipmitool';
369 $config['virsh'] = '/usr/local/bin/virsh';
370 $config['dot'] = '/usr/local/bin/dot';
371 $config['sfdp'] = '/usr/local/bin/sfdp';
372 $config['nfdump'] = '/usr/local/bin/nfdump';
375 AFFECTS: users of textproc/apache-solr
376 AUTHOR: mfechner@FreeBSD.org
378 Apache-solr switched to the supported java LTS version 11.
379 Make sure you update the following files accordingly:
380 /usr/local/etc/solr.in.sh (see /usr/local/etc/solr.in.sh.sample)
381 /usr/local/etc/javavm_opts.conf (JAVA_HOME=/usr/local/openjdk11/)
384 AFFECTS: users of net-mgmt/netbox
385 AUTHOR: kai@FreeBSD.org
387 1. Removal of the Topology Maps feature
389 The deprecated topology maps feature has been removed. Please replicate
390 any required data to another source before upgrading NetBox to v2.7.7, as
391 any existing topology maps will be deleted.
394 2. Changed REDIS database configuration settings
396 The REDIS database configuration parameters were splitted up in two
397 discrete subsections named "webhooks" and "caching" with the 2.7 release.
398 This requires modification of the REDIS parameter in configuration.py as
401 Old Redis sample configuration:
409 'DEFAULT_TIMEOUT': 300,
413 New Redis sample configuration:
417 'HOST': 'redis.example.com',
419 'PASSWORD': 'foobar',
421 'DEFAULT_TIMEOUT': 300,
429 'DEFAULT_TIMEOUT': 300,
434 Note that the CACHE_DATABASE parameter has been removed and the connection
435 settings have been duplicated for both webhooks and caching. This allows
436 one to make use of separate Redis instances if desired. It is fine to use
437 the same Redis service for both functions, although the database
438 identifiers should be different.
440 Please also check the pkg-message and the changelogs for further info.
443 AFFECTS: users of security/gsasl
444 AUTHOR: hrs@FreeBSD.org
446 The library part of security/gsasl has been split into security/libgsasl.
447 The security/gsasl now depends on security/libgsasl. Due to this change,
448 old security/gsasl conflicts with the new security/libgsasl and it can
449 prevent the installed security/gsasl from upgrading. Please remove the
450 installed security/gsasl before upgrading if a conflict error occurs.
453 AFFECTS: users of x11-servers/xorg-server
454 AUTHOR: zeising@FreeBSD.org
456 x11-servers/xorg-server has been updated to 1.20.7.
458 With this update, xorg-server has switched from using the devd backend to
459 the udev backend for device configuration on FreeBSD 12 and 13. If you have
460 issues with input devices, please see the install message for details.
462 The HAL backend option has been completely removed, as it was deprecated.
464 If you have problems with input devices, ensure that both x11/libinput and
465 x11-drivers/xf86-input-libinput are installed. They are installed in the
466 default configuration, but if you have a custom configuration, they might not
470 AFFECTS: users of net-im/prosody
471 AUTHOR: thomas@beingboiled.info
473 Prosody's pid file and data directory have moved to a new location.
474 If you are upgrading from a version with the pid file and data
475 directory in /usr/local/var/lib/prosody please perform these steps:
478 pkill -F /usr/local/var/lib/prosody/prosody.pid
480 # copy the data directory
481 cp -a /usr/local/var/lib/prosody /var/db/prosody
482 rm -f /var/db/prosody/prosody.pid
484 Make sure your prosody config has the following option set:
486 pidfile = "/var/run/prosody/prosody.pid"
488 Then start Prosody again. Everything should be working as before and
489 the /usr/local/var/lib/prosody directory can now be removed.
492 AFFECTS: users of security/nss
493 AUTHOR: lwhsu@FreeBSD.org
495 NSS header files and libraries have been moved from ${PREFIX}/include/nss/nss
496 and ${PREFIX}/lib/nss to ${PREFIX}/include/nss and ${PREFIX}/lib
499 AFFECTS: users of editors/vim
500 AUTHOR: adamw@FreeBSD.org
502 The PYTHON2 and PYTHON3 options have been turned into a single PYTHON
503 option that uses whichever python you've set as default. However,
504 this means that you cannot have both python2 and python3 support at
508 AFFECTS: users of multimedia/gstreamer1-plugins[-bad]
509 AUTHOR: kwm@freebsd.org
511 In GStreamer 1.16 some files moved from the gstreamer1-plugins-bad package
512 to the gstreamer1-plugins package.
514 If your using a tool like portmaster or portupgrade delete the old -bad
515 port and then follow the normal upgrade method.
516 # pkg delete -f gstreamer1-plugins-bad
519 AFFECTS: users of sysutils/helm
520 AUTHOR: danilo@FreeBSD.org
522 The Helm project have deprecated the Tiller utility in Helm 3. If you are using
523 Helm 2 you will need to migrate the configuration to be compatible with Helm 3.
524 Please, refer to the following documentation for more information about the
527 https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/
529 Note that the 2to3 plugin binary is not available for FreeBSD and you will need
530 to compile it yourself.
533 AFFECTS: users of python and net/samba410, devel/talloc, devel/tevent, databases/tdb, databases/ldb*
534 AUTHOR: timur@FreeBSD.org
536 In the entry 20191216 for the Python update the filtering constrains
537 are too limiting and omit the Samba supplimentary libraries, which do
538 have Python bindings to the default Python 3.x version. With the update
539 of the default Python3 version you also need to rebuild all the
540 supplimentary Samba libraries and samba410 itself.
542 For portmaster users it would be enough to run:
544 # portmaster devel/talloc devel/tevent databases/tdb databases/ldb15 net/samba410
549 AUTHOR: gecko@FreeBSD.org
551 Firefox requires Capsicum since r522464 for IPC and in future will
552 require Capsicum for process sandboxing. If you use a custom kernel
553 make sure to copy the following lines from GENERIC kernel:
555 options CAPABILITY_MODE # Capsicum capability mode
556 options CAPABILITIES # Capsicum capabilities
559 AFFECTS: Users of *-emacs27-* packages
560 AUTHOR: ashish@FreeBSD.org
562 There is a major version bump in 28.0.50, therefore to upgrade all the
563 packages dependent on editors/emacs-devel, please use the following commands:
566 # for i in $(pkg query -g %n '*-emacs27*'); do \
567 nn=$(echo "$i" | sed -e 's/emacs27/emacs28/'); \
568 pkg set -yn "$i":"$nn"; done;
572 AFFECTS: users of net/gnatsd
573 AUTHOR: olgeni@FreeBSD.org
575 net/gnatsd has been replaced by net/nats-server to reflect the
578 All options in rc.conf should be renamed by replacing 'gnats'
579 with 'nats' (nats_enable, nats_user, nats_options).
582 AFFECTS: users of security/openssl and security/openssl111
583 AUTHOR: brnrd@FreeBSD.org
585 The openssl port was removed on 2019-12-31, subsequently the openssl111
586 port was renamed to openssl on 2020-01-01.
588 The shared library version of OpenSSL has been bumped.
590 Users of DEFAULT_VERSIONS= ssl=openssl111 must update this to
593 You must rebuild all ports that depend on OpenSSL if you use OpenSSL
597 AFFECTS: users of sysutils/dsbmd
598 AUTHOR: mk@freeshell.de
600 With version 1.10 dsbmd now uses sysutils/fusefs-jmtpfs for mounting
601 MTP devices. Please adjust your dsbmd.conf or recreate it from the new
605 AFFECTS: multimedia/libva-intel-media-driver
606 AUTHOR: jbeich@FreeBSD.org
608 As of libva 2.6.0 iHD driver is automatically enabled, so you no
609 longer need to adjust LIBVA_DRIVER_NAME in ~/.profile or ~/.login.
612 AFFECTS: users of misc/openhab2
613 AUTHOR: netchild@FreeBSD.org
615 If you upgrade from a pevious version, make a backup of
617 read about the breaking changes in the release notes at
618 https://github.com/openhab/openhab-distro/releases/tag/2.5.0
620 %%PREFIX%%/libexec/openhab2/runtime/bin/update.freebsd
621 which takes care about changes for:
622 - Textual Configuration
623 - Next Generation Rule Engine
626 AFFECTS: users of python
627 AUTHOR: antoine@FreeBSD.org
629 Default version of python3 and python was switched to 3.7.
631 For ports users wanting to keep version 3.6 as default,
632 add DEFAULT_VERSIONS+= python=3.6 python3=3.6 to make.conf
634 This may ease the upgrade for users of pre-build packages:
636 # for i in $(pkg query -g %n 'py36-*'); do pkg set -yn ${i}:py37-${i#py36-}; done
639 For portmaster users:
641 # portmaster -o lang/python37 python36
642 # REINSTALL="$(pkg info -o py36-\* | awk '{printf "%s ", $2}')"
643 # pkg delete -f py36-\*
644 # portmaster $REINSTALL
645 # REBUILD=$(pkg query -g "%n:%dn" '*' | grep py3 | grep -v py37 | cut -d : -f 1 | sort -u)
646 # portmaster $REBUILD
647 # REBUILD2=$(pkg list | grep python-36 | xargs pkg which | awk '{print $6}' | sort -u)
648 # portmaster $REBUILD2
651 AFFECTS: users of mail/nextcloud-mail
652 AUTHOR: brnrd@FreeBSD.org
654 Version 0.20.0 removed the default mail configuration via config.php.
655 All users will be prompted to enter account and SMTP- and IMAP-server
656 details for sending and reading email.
659 AFFECTS: consumers of net/py-urllib3
660 AUTHOR: kai@FreeBSD.org
662 Since version 1.25 HTTPS connections are now verified by default which is
663 done via "cert_reqs = 'CERT_REQUIRED'". While certificate verification
664 can be disabled via "cert_reqs = 'CERT_NONE'", it's highly recommended to
667 Various consumers of net/py-urllib3 already have implemented routines that
668 either explicitly enable or disable HTTPS certificate verification (e.g.
669 via configuration settings, CLI arguments, etc.).
671 Yet it may happen that there are still some consumers which don't
672 explicitly enable/disable certificate verification for HTTPS connections
673 which could then lead to errors (as is often the case with self-signed
676 In case of an error one should try first to temporarily disable
677 certificate verification of the problematic urllib3 consumer to see if
678 this approach will remedy the issue.
681 AFFECTS: users of emulators/qemu
682 AUTHOR: bofh@FreeBSD.org
684 emulators/qemu31 has been updated to 4.1.1. Previous 3.1.X branch has
685 been repocopied to emulators/qemu31. If someone wants to stick with 3.1.X
686 branch please use one of the following command:
688 # pkg install emulators/qemu31
690 # portmaster -o emulators/qemu31 emulators/qemu
692 # portupgrade -o emulators/qemu31 emulators/qemu
695 AFFECTS: users of irc/eggdrop
696 AUTHOR: dbaio@FreeBSD.org
698 The irc/eggdrop port has been updated to 1.8.4 and its config is not
699 backward compatible with 1.6.21. A new port was created to keep 1.6.21
700 version available at irc/eggdrop16 and it will be available for 3 months
701 until users have time to upgrade their configuration.
704 https://raw.githubusercontent.com/eggheads/eggdrop/v1.8.4/NEWS
706 If you would like to keep using 1.6.21, please run the following command
707 to update pkg database:
709 pkg set -n eggdrop:eggdrop16
710 pkg set -o irc/eggdrop:irc/eggdrop16
713 AFFECTS: users of databases/redis[-devel]
714 AUTHOR: osa@FreeBSD.org
716 The databases/redis port has been updated to the recent stable release.
717 Users wanting to stay on v4.x can replace databases/redis with
718 databases/redis4 with one of the following commands:
720 # pkg install databases/redis4
722 # portmaster -o databases/redis4 databases/redis
724 # portupgrade -o databases/redis4 databases/redis
727 AFFECTS: users of www/node
728 AUTHOR: bhughes@FreeBSD.org
730 The www/node port has been updated to Node.js v13.0.0, the latest
731 upstream release. A new port, www/node12, has been created for the
732 v12.x LTS branch. Users wanting to stay on v12.x can replace www/node
733 with www/node12 with one of the following commands:
735 # pkg install www/node12
737 # portmaster -o www/node12 www/node
739 # portupgrade -o www/node12 www/node
742 AFFECTS: users of emulators/open-vm-tools[-nox11]
743 AUTHOR: jpaetzel@FreeBSD.org
745 open-vm-tools 11.0.1 has removed the vmxnet driver. This driver has been
746 in tree for quite some time and hopefully everyone is using the in tree
747 version, however if you had removed device vmx from your kernel, or are
748 running an unsupported version of FreeBSD which didn't have the driver
749 included in the base system, updating your open-vm-tools version will
750 leave you without networking.
753 AFFECTS: users of www/qt5-webengine
754 AUTHOR: kai@FreeBSD.org
756 Users that upgrade www/qt5-webengine without using pkg/poudriere might
757 experience failures due to conflicts with the installed version of 5.12.2.
759 In that case, pkg delete -f the qt5-webengine package before building
763 AFFECTS: users of x11/nvidia-driver (and slave ports)
764 AUTHOR: danfe@FreeBSD.org
766 x11/nvidia-driver* ports no longer install Linux programs and libraries,
767 which had been moved to their own ports (x11/linux-nvidia-libs*). When
768 updating the driver package next time, remember to install them manually
769 if you need to run Linux OpenGL programs.
772 AFFECTS: users of KDE Plasma Desktop (x11/plasma5*)
773 AUTHOR: kde@FreeBSD.org
775 With Plasma 5.17 the startup script has been renamed. People who use the
776 .xinitrc method to start Plasma have to call the new binary.
779 exec ck-launch-session startkde
781 exec ck-launch-session startplasma-x11
784 AFFECTS: users of mail/rspamd, mail/rspamd-devel
785 AUTHOR: vsevolod@FreeBSD.org
787 Sample configuration files has been removed as default configuration files
788 are NOT intended for modification by users and SHOULD be overwritten on
791 Make sure the default configuration files are unmodified and migrate all
792 configuration changes to the proper places, before you continue.
795 AFFECTS: users of textproc/groff
796 AUTHOR: bapt@FreeBSD.org
798 with groff 1.2.4_3, groff does not depend anymore on ghostscript and
799 netpbm. In order to be able to properly use the html backend the user
800 can install ghostscript and netpbm from ports without the need of
801 reinstalling the package.
803 Also note that the X11 option has been removed.
806 AFFECTS: users of net-mgmt/netbox
807 AUTHOR: kai@FreeBSD.org
809 Since the 2.6 release a running Redis server instance is required for
810 caching objects to run. Also the following settings like below need to be
811 added (or modified) in the existing configuration.py:
819 'DEFAULT_TIMEOUT': 300,
823 Note that if you were using these settings in a prior release with
824 webhooks, the DATABASE setting remains the same but an additional
825 CACHE_DATABASE settings has been added with a default value of 1 to
826 support the caching backend.
828 The DATABASE setting will be renamed in a future release of NetBox to
829 better relay the meaning of the setting. It is highly recommended to keep
830 the webhook and cache databases separate. Using the same database number
831 for both may result in webhook processing data being lost during cache
834 Please also check the pkg-message and the changelogs for further info.
837 AFFECTS: users of emulators/qemu-devel
838 AUTHOR: bofh@FreeBSD.org
840 qemu-devel has been updated to 4.1.0 and 4.0.0 has been merged into a new port
841 emulators/qemu40. If you want to stick with 4.0.X branch, simply use:
842 # portmaster -o emulators/qemu-devel emulators/qemu40
845 AFFECTS: users of XFCE desktop (x11-wm/xfce4)
846 AUTHOR: madpilot@FreeBSD.org
848 Due to changes in the XFCE 4.14 metaport, systems could end up with
849 both xscreensaver and xfce4-screensaver installed and enabled
852 This can cause conflicts and problems unlocking the screen.
854 To avoid problems, please make sure to have only one enabled by
855 going to the Application Autostart tab of the Session and Startup
856 settings applet and enable only one Screensaver there.
858 Some further information can be found in the xfce4-session
859 pkg-message displayed on installation and upgrade.
862 AFFECTS: users of net-mgmt/pushgateway
863 AUTHOR: 0mp@FreeBSD.org
865 The persistent storage format used by pushgateway in the latest version
866 is not backwards compatible. See the pushgateway changelogs for details.
869 AFFECTS: users of security/bastillion
870 AUTHOR: netchild@FreeBSD.org
872 The datastore of bastillion needs to be updated:
873 java -jar $PREFIX/jetty_bastillion/upgrade/bastillion-upgrade-3.08.00.jar \
874 $PREFIX/jetty_bastillion/bastillion/WEB-INF/classes/BastillionConfig.properties
877 AFFECTS: users of lang/ruby25
878 AUTHOR: mfechner@FreeBSD.org
880 The default ruby version has been updated from 2.5 to 2.6.
882 If you compile your own ports you may keep 2.5 as the default version by
883 adding the following lines to your /etc/make.conf file:
886 # Keep ruby 2.5 as default version
888 DEFAULT_VERSIONS+=ruby=2.5
890 If you wish to update to the new default version, you need to first stop any
891 software that uses ruby. Then, you will need to follow these steps, depending
892 upon how you manage your system.
894 If you use pkgng, simply upgrade:
897 If you do not use pkg, please check entry 20190420.
898 The description there should also work for this version.
901 AFFECTS: users of devel/py-fabric
902 AUTHOR: dbaio@FreeBSD.org
904 Fabric (devel/py-fabric) was upgraded to 2.5.0, Fabric (2+) represents
905 a near-total reimplementation and reorganization of the software.
907 Fabric 2 is not at 100% feature parity with 1.x! Some features have been
908 explicitly dropped, but others simply have not been ported over yet,
909 either due to time constraints or because said features need to be
910 re-examined in a modern context.
913 https://www.fabfile.org/upgrading.html#upgrading
914 https://www.fabfile.org/upgrading.html#upgrade-specifics
916 If you would like to keep using 1.x, please run the following command to
919 pkg set -n py27-fabric:py27-fabric1
920 pkg set -o devel/py-fabric:devel/py-fabric1
923 AFFECTS: users of www/gitlab-ce
924 AUTHOR: mfechner@FreeBSD.org
926 Make sure you upgrade your PostgreSQL to version 11 as described in 20190829,
927 before you upgrade your gitlab-ce version.
928 Gitlab-ce 12.1 needs at least PostgreSQL version 9.6.
930 After this you can follow the usual upgrade guide:
931 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/12.0-12.1-freebsd.md
934 AFFECTS: users of database/postgresql* and other software using PostgreSQL to run
935 AUTHOR: tz@FreeBSD.org
937 The default version of PostgreSQL has been switched from 9.5 to 11.
938 The upgrade procedure can use up twice the space the databases
939 currently needs. If you have a big amount of stored data take a
940 closer look at the manpage of pg_upgrade for avoidance and/or
941 speedup of the upgrade.
943 The upgrade instructions consider a basic usage and do not match
944 complex scenarios like replication, sharding, or similar.
946 Upgrade instructions:
948 First stop your PostgreSQL, create PostgreSQL-binaries and backup your data.
949 If you have another Version of PostgreSQL installed, for example 9.5.19, your
950 files are named according to this.
952 # service postgresql stop
953 # pkg create postgresql95-server postgresql95-contrib
954 # mkdir /tmp/pg-upgrade
955 # tar xf postgresql95-server-9.5.19.txz -C /tmp/pg-upgrade
956 # tar xf postgresql95-contrib-9.5.19.txz -C /tmp/pg-upgrade
957 # pkg delete -f databases/postgresql95-server databases/postgresql95-contrib databases/postgresql95-client
959 Now update PostgreSQL:
962 # pkg install databases/postgresql11-server databases/postgresql11-contrib
966 # portmaster databases/postgresql11-server databases/postgresql11-contrib
970 # portinstall databases/postgresql11-server databases/postgresql11-contrib
973 After installing the new PostgreSQL version you need to convert
974 all your databases to new version:
976 # su -l postgres -c "/usr/local/bin/initdb --encoding=utf-8 --lc-collate=C -D /var/db/postgres/data11 -U pgsql"
977 # chown -R postgres /usr/local/pgsql/data/
978 # 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 "
980 Now the migration is finished. You can start PostgreSQL again with:
982 # service postgresql start
985 1) The default user changed from "pgsql" to "postgres". The migration steps above preserve
986 the "pgsql" database user while the database daemon is now executed as the "postgres" FreeBSD user.
987 2) The default data dir changed from "/usr/local/pgsql/data/" to "/var/db/postgres/data11/"
988 3) If you use non-default initdb options, you have to adjust the initdb-command accordingly
991 AFFECTS: users of net-im/ejabberd
992 AUTHOR: ashish@FreeBSD.org
994 Riak support has been removed by upstream. For update instructions from
995 19.05, please refer to:
997 https://docs.ejabberd.im/admin/upgrade/from_19.05_to_19.08/
1000 AFFECTS: users of lang/perl5*
1001 AUTHOR: mat@FreeBSD.org
1003 The default Perl version has been switched to Perl 5.30. If you are using
1004 binary packages to upgrade your system, you do not have anything to do, pkg
1005 upgrade will do the right thing. For the other people, follow the
1006 instructions in entry 20161103, it should still be the same.
1009 AFFECTS: users of www/ot-recorder
1010 AUTHOR: dvl@FreeBSD.org
1012 The data directory has moved from /var/spool/owntracks to
1015 Be sure to stop otrecorder, move the directory, and start otrecorder.
1017 service ot-recorder stop
1019 mv owntracks /var/db
1020 service ot-recorder start
1023 AFFECTS: users of net-im/py-matrix-synapse
1024 AUTHOR: kai@FreeBSD.org
1026 The support for Python 2.7 has been dropped with the 1.1.0 release of
1027 net/py-matrix-synapse.
1029 Users that still use the Python 2.7 version of net-im/py-matrix-synapse
1030 should switch to a newer Python version, e.g. 3.6, which is the default
1031 Python version since April 2019.
1034 AFFECTS: users of net-p2p/zetacoin and net-p2p/zetacoin-nox11
1035 AUTHOR: daniel@morante.net
1037 Zetacoin will default to using modern versions of BDB (5.x or 6.x) when
1038 the WALLET option is selected. See pkg-help for explanation.
1040 The zetacoin-nox11 slave port was renamed to zetacoin-daemon to align
1041 with the net-p2p/bitcoin format.
1043 The zetacoin-cli and zetacoin-tx utilities have been re-packaged into
1044 a separate port. If you require these programs, or use the zetacoin-cli
1045 program to access the daemon or the GUI, install net-p2p/zetacoin-utils
1049 AFFECTS: users of sysutils/py-borgmatic
1050 AUTHOR: egypcio@FreeBSD.org
1052 The default location for borgmatic's configurations changed. We moved it
1053 from '/etc/borgmatic' to '/usr/local/etc/borgmatic' in order to follow
1054 recommended standards used on FreeBSD.
1057 AFFECTS: users with DEFAULT_VERSIONS+=linux=c6 or c6_64 in /etc/make.conf
1058 AUTHOR: tijl@FreeBSD.org
1060 On amd64 adding DEFAULT_VERSIONS+=linux=c6 to /etc/make.conf made Linux
1061 infrastructure ports (linux_base-c6 and linux-c6*) install i386 CentOS 6
1062 packages. Using c6_64 instead of c6 made them install mixed amd64/i386
1063 CentOS 6 packages and allowed Linux application ports to install amd64
1064 binaries when available. The i386-only configuration was only useful for
1065 users of x11/nvidia-driver* which didn't provide Linux amd64 emulation
1068 With x11/nvidia-driver* now supporting Linux amd64 there's no longer a
1069 need for i386-only Linux on amd64 so DEFAULT_VERSIONS+=linux=c6 has been
1070 changed to make Linux infrastructure ports install mixed amd64/i386
1071 CentOS 6 packages, like c6_64 before, and support for c6_64 has been
1074 Users with DEFAULT_VERSIONS+=linux=c6 should reinstall linux_base-c6 and
1075 all packages that depend on it. A list of dependent packages can be
1076 obtained with the following command:
1078 pkg info -r linux_base-c6
1080 Users with DEFAULT_VERSIONS+=linux=c6_64 only need to replace c6_64 with
1081 c6 in /etc/make.conf.
1083 Users of x11/nvidia-driver* should upgrade to FreeBSD 11.3 or 12.0 if
1084 they want to run Linux amd64 OpenGL programs. If you are running an
1085 older version you may want to postpone installing or updating Linux
1086 application ports until you find the time to upgrade because application
1087 ports may install amd64 binaries now. Infrastructure ports are safe to
1088 reinstall, and so is x11/nvidia-driver*.
1090 On i386 nothing has changed.
1093 AFFECTS: users of www/gitlab-ce
1094 AUTHOR: mfechner@FreeBSD.org
1096 You must at first upgrade to version 11.11.5 before you can upgrade
1098 Support for MySQL will be dropped with next version.
1099 Make sure you use at least PostgreSQL version 9.6.
1100 Follow the normal upgrade manual that can be found here:
1101 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/11.11-12.0-freebsd.md
1104 AFFECTS: users of net/serviio which bought a license for the non-free features
1105 AUTHOR: netchild@FreeBSD.org
1107 Version 2 of serviio needs a new license file. Updating without a new license
1108 file will disable the non-free features.
1111 AFFECTS: users of databases/mysql56-(server|client)
1112 AUTHOR: ale@FreeBSD.org
1114 The default MySQL version has been updated from 5.6 to 5.7.
1116 If you compile your own ports you may keep 5.6 as the default version by
1117 adding the following lines to your /etc/make.conf file:
1120 # Keep MySQL 5.6 as default version
1122 DEFAULT_VERSIONS+=mysql=5.6
1124 If you wish to update to the new default version, you need to first stop any
1125 running server instance. Then, you will need to follow these steps, depending
1126 on installed packages.
1128 # pkg set -o databases/mysql56-client:databases/mysql57-client
1129 # pkg set -o databases/mysql56-server:databases/mysql57-server
1133 AFFECTS: users of net/samba410
1134 AUTHOR: timur@FreeBSD.org
1136 If you used Samba in AD/DC mode with the previous versions of the port on UFS2
1137 backed storage you have to add usage of vfs_freebsd VFS module for at least
1138 SYSVOL share and configure it to use 'legacy' mode(see manpage).
1140 The reason behind this is that previous versions Samba port used a hack to
1141 workaround broken mapping of Linux security and trusted extended attributes
1142 into FreeBSD namespace. In particular, essential security.NTACL attribute
1143 was replaced with the user.NTACL and placed in a insecure USER namespace.
1145 This port dropped this hack in favor of vfs_freebsd module, which should
1146 provide more controlled way of such a mapping.
1148 To maintain the compatibility with the previous installations on UFS2 storage
1149 (as ZFS uses it's own way of mapping SYSVOL, thanks to the iXsystems patches)
1150 the vfs_freebsd module provides 'legacy' mode that implements old functionality.
1152 For the fresh installations it is recommended to use 'secure' mode of operations
1153 for this module and use it as a global vfs objects.
1155 Caution: The given module is still considered EXPERIMENTAL.
1158 AFFECTS: users of net/samba410, net/samba4[6-8] and devel/talloc?, devel/tevent?, databases/tdb?, databases/ldb*
1159 AUTHOR: timur@FreeBSD.org
1161 The port of the new version of Samba 4.10 is introduced. Due necessarily
1162 to keep backwards compatibility for the legacy samba4[6-8] ports the
1163 upgrade procedure is a bit convoluted.
1165 You are safe to perform fresh new install of samba410 port. In case you
1166 are upgrading from the previous versions of Samba, please use the
1167 following procedure:
1169 0. Take backups of all the relevant files, in particular PREFIX/etc/smb4.conf
1170 and /var/db/samba4/ subdirectory. Keep in mind that files there (may)
1171 have extended attributes, so use appropriate tools to preserve them.
1173 1a. If you haven't updated Samba between 20190619 and 20190630 then next
1174 step should be as simple as:
1176 portmaster -o net/samba410 net/samba48
1178 1b. If you have been affected by the archiving legacy versions of
1179 Samba-related libraries for legacy versions of Samba, which happened
1180 in the given time frame, then you need to reverse operation from the
1183 for users of portmaster:
1184 portmaster -o devel/talloc devel/talloc1
1185 portmaster -o devel/tevent devel/tevent1
1186 portmaster -o databases/tdb databases/tdb1
1187 portmaster -o net/samba410 net/samba48
1189 for users of portupgrade:
1190 portupgrade -o devel/talloc devel/talloc1
1191 portupgrade -o devel/tevent devel/tevent1
1192 portupgrade -o databases/tdb databases/tdb1
1193 portupgrade -o net/samba410 net/samba48
1196 AFFECTS: users of samba4[6-8] and devel/talloc, devel/tevent, databases/tdb, databases/ldb*
1197 AUTHOR: timur@FreeBSD.org
1199 To introduce samba410(we deliberately skip samba49 due the complexity of handling)
1200 and to drop dependency on deprecated Python 2.7, Samba supplementary libraries
1201 talloc, tevent and tdb were split into current Python 3 compatible versions
1202 and legacy ones, with the suffix "1".
1204 Old versions of Samba were changed to depend on the legacy supplementary libraries,
1205 so if you need to install samba46, samba47 or samba48 over previous Samba
1206 installations you need to downgrade supplementary libs with the following commands:
1208 for users of portmaster:
1209 portmaster -o devel/talloc1 devel/talloc
1210 portmaster -o devel/tevent1 devel/tevent
1211 portmaster -o databases/tdb1 databases/tdb
1212 portmaster -r talloc1
1214 for users of portupgrade:
1215 portupgrade -o devel/talloc1 devel/talloc
1216 portupgrade -o devel/tevent1 devel/tevent
1217 portupgrade -o databases/tdb1 databases/tdb
1218 portupgrade -fr devel/talloc1
1221 AFFECTS: users of www/qt5-webengine
1222 AUTHOR: kai@FreeBSD.org
1224 Users that upgrade www/qt5-webengine without using pkg/poudriere might
1225 experience failures due to conflicts with the installed version of 5.12.2.
1227 In that case, pkg delete -f the qt5-webengine package before building
1228 the updated version.