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 net-im/pidgin-rocketchat
10 AUTHOR: tobias.rehbein@web.de
12 This port has been turned into a libpurple plugin (net-im/purple-rocketchat)
13 to support other libpurple clients than pidgin.
15 This also changes some dependencies and you should run the following command
16 to prevent pidgin from being autoremoved.
18 # mark pidgin as being not automatically installed
22 AFFECTS: users of x11-wm/hs-xmonad
23 AUTHOR: arrowd@FreeBSD.org
25 From now, it is recommended to use "build script" method to compile XMonad
26 config. See https://github.com/xmonad/xmonad-testing/ for general info and
27 port's pkg-message for concrete steps.
30 AFFECTS: users of net-mgmt/librenms
31 AUTHOR: dvl@FreeBSD.org
33 Polling via cronjob is deprecated as of release 1.63
34 see see https://community.librenms.org/t/dropping-support-for-php-7-1-and-python-2/11851
36 Please migrate to the Dispatch Service:
37 https://docs.librenms.org/Extensions/Dispatcher-Service/
39 These steps should get you running:
40 * comment out the crontab entries listed above under PYPOLLER
41 * populate %%WWWDIR%%/.env with:
42 * APP_KEY - see farther below for how to create
43 * NODE_ID - see just below for how to create
48 * you can create a NODE_ID with: php -r 'echo uniqid() . "\n";'
49 * sysrc librenms_enable="YES"
50 * service librenms start
53 AFFECTS: users of www/phpmyfaq
54 AUTHOR: flo@FreeBSD.org
56 phpMyFAQ has been updated to 3.0.2, old templates are not compatible with
57 this new version. Please see:
59 https://www.phpmyfaq.de/docs/3.0#3.4
62 AFFECTS: users of sysutils/ansible
63 AUTHOR: bofh@FreeBSD.org
65 Ansible has been updated to 2.9.7. Please follow the porting guide
66 to update the rulesets:
68 https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_2.9.html
70 If you wish to stay with 2.8 version, you can switch
71 to new sysutils/ansible28 port, which tracks stable 2.8 branch:
73 # pkg set -n ansible:ansible28
76 AFFECTS: x11-servers/xwayland-devel
77 AUTHOR: jbeich@FreeBSD.org
79 DRI3 is enabled by default since mesa-libs-18.3.2_4, so you no
80 longer need to define LIBGL_DRI3_ENABLE in ~/.profile or ~/.login.
82 See 20200308 entry for more details.
85 AFFECTS: users of devel/kyua
86 AUTHOR: brooks@FreeBSD.org
88 A tests group has been added and the tests user should be a member
89 of it by default rather than nobody. You should update your password
90 database to match (change the group from 65534 to 977 after updating).
92 Please use the following command to do so:
94 pw usermod -n tests -g tests
97 AFFECTS: users of security/openssh-portable
98 AUTHOR: bdrewery@FreeBSD.org
100 OpenSSH was upgraded to 8.2p1 on 2020-03-23.
102 A restart of sshd is required after upgrade due to an incompatibility
105 Please see https://www.openssh.com/txt/release-8.2 for upcoming
109 AFFECTS: users of net/irrd
110 AUTHOR: bofh@FreeBSD.org
112 Legacy version of net/irrd has been moved to net/irrd-legacy.
113 net/irrd has been upgraded to 4.X branch. If someone wants to stick with
114 legacy version then pkg users have to do something like
116 # pkg set -o net/irrd:net/irrd-legacy
119 # portmaster -o net/irrd-legacy net/irrd
121 Both of the version can be installed and used concurrently in case there is
125 AFFECTS: users of x11-fonts/fontconfig
126 AUTHOR: desktop@FreeBSD.org
128 Fontconfig 2.13.1 generated .uuid files in the fonts directory which where
129 not properly registered to the packages. To clean them up, please execute the
132 find /usr/local/share/fonts -type f -name .uuid -delete
135 AFFECTS: users of devel/sonarqube and devel/sonar-ant-task
136 AUTHOR: netchild@FreeBSD.org
138 The outdated port devel/sonarqube has moved to
139 devel/sonarqube-community to make it clear that it is the community
140 edition. The log and DB files are still stored in the same location.
142 The devel/sonar-ant-task port has moved to devel/sonarqube-ant-task
143 to match the upstream-name. The install location is renamed
146 At the same time the user/group of the sonarqube port changed from
147 www:www to sonarqube:sonarqube.
149 It is expected that nobody was using the 6.2 version from 2016
150 anymore and no change needs to be done. No analysis was done to check
151 if the old 6.2 version can be updated in-place to the 8.2 version.
152 As such if there is still someone using the old 6.2 version, you may
153 have to delete /var/log/sonarqube and /var/db/sonarqube before
154 installing the new version.
157 AFFECTS: users of devel/qca
158 AUTHOR: kde@FreeBSD.org
160 New versions of devel/qca stopped supporting OpenSSL < 1.1.
161 For this reason devel/qca-legacy has been added, which is
162 held back at an older version until FreeBSD 11 goes EOL.
164 Ports depending on devel/qca should stop adding direct LIB_DEPENDS
165 and switch to depending on it via USES=qca.
167 FreeBSD 11 users might want to run something like
169 pkg set -o devel/qca:devel/qca-legacy
172 AFFECTS: users of x11/libxkbcommon
173 AUTHOR: zeising@FreeBSD.org
175 The libxkbcommon library (x11/libxkbcommon), used to handle keyboards
176 in some applications, most notably kde and wayland, have been switched
177 to use evdev rules by default on FreeBSD 12 and later. Some keys, most
178 notably arrow keys, may not work in applications using libxkbcommon if
179 you are using xf86-input-keyboard rather than xf86-input-libinput.
180 If you have trouble with the keyboard keys, and if /var/log/Xorg.*.log
181 shows that the "kbd" or "keyboard" driver is being used, you need to
182 switch to legacy rules by setting the environment variable
183 XKB_DEFAULT_RULES to xorg.
184 This switch is made to match the default configuration on FreeBSD 12.1 and
185 later, the default configuration on FreeBSD 11.3 still uses the legacy
189 AFFECTS: users of net-im/slack-term
190 AUTHOR: dmgk@FreeBSD.org
192 The config file location was changed from ~/.slack-term to
193 ~/.config/slack-term/config, please move your existing config file
197 AFFECTS: users of graphics/mesa-libs and legacy graphics drivers
198 AUTHOR: zeising@FreeBSD.org
200 The mesa OpenGL library (graphics/mesa-libs) has been switched to use DRI3
201 by default, instead of the older DRI2 interface. This might cause regressions
202 when using the legacy graphics drivers, either through
203 graphics/drm-legacy-kmod or the graphics drivers in base.
205 If you experience issues when running OpenGL applications it is possible
206 to force the use of DRI2 by setting the LIBGL_DRI3_DISABLE environment
207 variable to 1 before starting any OpenGL application. The easiest way to
208 do this is by adding it to either your shell startup files or .xinitrc.
211 AFFECTS: users of databases/mysql80-server
212 AUTHOR: joneum@FreeBSD.org
214 As of MySQL 8.0.16, the MySQL server performs the upgrade tasks previously
215 handled by mysql_upgrade. Consequently, mysql_upgrade is unneeded and is
216 deprecated as of that version, and will be removed in a future MySQL version.
217 Because mysql_upgrade no longer performs upgrade tasks,
218 it exits with status 0 unconditionally.
221 AFFECTS: users of net-mgmt/librenms
222 AUTHOR: dvl@FreeBSD.org
224 1. Apache / mod_php options removed
226 The APACHEMOD option has been removed. LibreNMS can be used
227 with other webservers, not just Apache. In order to simplify
228 the port, the option was removed.
230 Now you manually install the webserver of your preference.
232 If upgrading from LibreNMS < 1.61, you can do this to
233 prevent 'pkg autoremove' from uninstalling Apache / mod_php:
235 $ sudo pkg set -A 0 apache24 mod_php74
236 Mark apache24-2.4.41 as not automatically installed? [y/N]: y
237 Mark mod_php74-7.4.3 as not automatically installed? [y/N]: y
239 Adjust mod_php74 to suit the version of mod_php you have.
241 2. include/defaults.inc.php is gone
243 The file include/defaults.inc.php is no longer distributed by
244 the upstream project. The FreeBSD port patched this file to
245 correct the paths to common tools such as ping, snmpwalk, etc.
247 These values previously adjusted by the port must now be specified
248 in config.php. New installs will have this automatically, but existing
249 installs must be updated manually. These are the entries you should
250 add if upgrading from LibreNMS < 1.61:
252 $config['snmpwalk'] = '/usr/local/bin/snmpwalk';
253 $config['snmpget'] = '/usr/local/bin/snmpget';
254 $config['snmpbulkwalk'] = '/usr/local/bin/snmpbulkwalk';
255 $config['snmptranslate'] = '/usr/local/bin/snmptranslate';
257 $config['ping'] = '/sbin/ping';
258 $config['mtr'] = '/usr/local/bin/mtr';
259 $config['nmap'] = '/usr/local/bin/nmap';
261 $config['nagios_plugins'] = '/usr/local/libexec/nagios';
262 $config['ipmitool'] = '/usr/local/bin/ipmitool';
263 $config['virsh'] = '/usr/local/bin/virsh';
264 $config['dot'] = '/usr/local/bin/dot';
265 $config['sfdp'] = '/usr/local/bin/sfdp';
266 $config['nfdump'] = '/usr/local/bin/nfdump';
269 AFFECTS: users of textproc/apache-solr
270 AUTHOR: mfechner@FreeBSD.org
272 Apache-solr switched to the supported java LTS version 11.
273 Make sure you update the following files accordingly:
274 /usr/local/etc/solr.in.sh (see /usr/local/etc/solr.in.sh.sample)
275 /usr/local/etc/javavm_opts.conf (JAVA_HOME=/usr/local/openjdk11/)
278 AFFECTS: users of net-mgmt/netbox
279 AUTHOR: kai@FreeBSD.org
281 1. Removal of the Topology Maps feature
283 The deprecated topology maps feature has been removed. Please replicate
284 any required data to another source before upgrading NetBox to v2.7.7, as
285 any existing topology maps will be deleted.
288 2. Changed REDIS database configuration settings
290 The REDIS database configuration parameters were splitted up in two
291 discrete subsections named "webhooks" and "caching" with the 2.7 release.
292 This requires modification of the REDIS parameter in configuration.py as
295 Old Redis sample configuration:
303 'DEFAULT_TIMEOUT': 300,
307 New Redis sample configuration:
311 'HOST': 'redis.example.com',
313 'PASSWORD': 'foobar',
315 'DEFAULT_TIMEOUT': 300,
323 'DEFAULT_TIMEOUT': 300,
328 Note that the CACHE_DATABASE parameter has been removed and the connection
329 settings have been duplicated for both webhooks and caching. This allows
330 one to make use of separate Redis instances if desired. It is fine to use
331 the same Redis service for both functions, although the database
332 identifiers should be different.
334 Please also check the pkg-message and the changelogs for further info.
337 AFFECTS: users of security/gsasl
338 AUTHOR: hrs@FreeBSD.org
340 The library part of security/gsasl has been split into security/libgsasl.
341 The security/gsasl now depends on security/libgsasl. Due to this change,
342 old security/gsasl conflicts with the new security/libgsasl and it can
343 prevent the installed security/gsasl from upgrading. Please remove the
344 installed security/gsasl before upgrading if a conflict error occurs.
347 AFFECTS: users of x11-servers/xorg-server
348 AUTHOR: zeising@FreeBSD.org
350 x11-servers/xorg-server has been updated to 1.20.7.
352 With this update, xorg-server has switched from using the devd backend to
353 the udev backend for device configuration on FreeBSD 12 and 13. If you have
354 issues with input devices, please see the install message for details.
356 The HAL backend option has been completely removed, as it was deprecated.
358 If you have problems with input devices, ensure that both x11/libinput and
359 x11-drivers/xf86-input-libinput are installed. They are installed in the
360 default configuration, but if you have a custom configuration, they might not
364 AFFECTS: users of net-im/prosody
365 AUTHOR: thomas@beingboiled.info
367 Prosody's pid file and data directory have moved to a new location.
368 If you are upgrading from a version with the pid file and data
369 directory in /usr/local/var/lib/prosody please perform these steps:
372 pkill -F /usr/local/var/lib/prosody/prosody.pid
374 # copy the data directory
375 cp -a /usr/local/var/lib/prosody /var/db/prosody
376 rm -f /var/db/prosody/prosody.pid
378 Make sure your prosody config has the following option set:
380 pidfile = "/var/run/prosody/prosody.pid"
382 Then start Prosody again. Everything should be working as before and
383 the /usr/local/var/lib/prosody directory can now be removed.
386 AFFECTS: users of security/nss
387 AUTHOR: lwhsu@FreeBSD.org
389 NSS header files and libraries have been moved from ${PREFIX}/include/nss/nss
390 and ${PREFIX}/lib/nss to ${PREFIX}/include/nss and ${PREFIX}/lib
393 AFFECTS: users of editors/vim
394 AUTHOR: adamw@FreeBSD.org
396 The PYTHON2 and PYTHON3 options have been turned into a single PYTHON
397 option that uses whichever python you've set as default. However,
398 this means that you cannot have both python2 and python3 support at
402 AFFECTS: users of multimedia/gstreamer1-plugins[-bad]
403 AUTHOR: kwm@freebsd.org
405 In GStreamer 1.16 some files moved from the gstreamer1-plugins-bad package
406 to the gstreamer1-plugins package.
408 If your using a tool like portmaster or portupgrade delete the old -bad
409 port and then follow the normal upgrade method.
410 # pkg delete -f gstreamer1-plugins-bad
413 AFFECTS: users of sysutils/helm
414 AUTHOR: danilo@FreeBSD.org
416 The Helm project have deprecated the Tiller utility in Helm 3. If you are using
417 Helm 2 you will need to migrate the configuration to be compatible with Helm 3.
418 Please, refer to the following documentation for more information about the
421 https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/
423 Note that the 2to3 plugin binary is not available for FreeBSD and you will need
424 to compile it yourself.
427 AFFECTS: users of python and net/samba410, devel/talloc, devel/tevent, databases/tdb, databases/ldb*
428 AUTHOR: timur@FreeBSD.org
430 In the entry 20191216 for the Python update the filtering constrains
431 are too limiting and omit the Samba supplimentary libraries, which do
432 have Python bindings to the default Python 3.x version. With the update
433 of the default Python3 version you also need to rebuild all the
434 supplimentary Samba libraries and samba410 itself.
436 For portmaster users it would be enough to run:
438 # portmaster devel/talloc devel/tevent databases/tdb databases/ldb15 net/samba410
443 AUTHOR: gecko@FreeBSD.org
445 Firefox requires Capsicum since r522464 for IPC and in future will
446 require Capsicum for process sandboxing. If you use a custom kernel
447 make sure to copy the following lines from GENERIC kernel:
449 options CAPABILITY_MODE # Capsicum capability mode
450 options CAPABILITIES # Capsicum capabilities
453 AFFECTS: Users of *-emacs27-* packages
454 AUTHOR: ashish@FreeBSD.org
456 There is a major version bump in 28.0.50, therefore to upgrade all the
457 packages dependent on editors/emacs-devel, please use the following commands:
460 # for i in $(pkg query -g %n '*-emacs27*'); do \
461 nn=$(echo "$i" | sed -e 's/emacs27/emacs28/'); \
462 pkg set -yn "$i":"$nn"; done;
466 AFFECTS: users of net/gnatsd
467 AUTHOR: olgeni@FreeBSD.org
469 net/gnatsd has been replaced by net/nats-server to reflect the
472 All options in rc.conf should be renamed by replacing 'gnats'
473 with 'nats' (nats_enable, nats_user, nats_options).
476 AFFECTS: users of security/openssl and security/openssl111
477 AUTHOR: brnrd@FreeBSD.org
479 The openssl port was removed on 2019-12-31, subsequently the openssl111
480 port was renamed to openssl on 2020-01-01.
482 The shared library version of OpenSSL has been bumped.
484 Users of DEFAULT_VERSIONS= ssl=openssl111 must update this to
487 You must rebuild all ports that depend on OpenSSL if you use OpenSSL
491 AFFECTS: users of sysutils/dsbmd
492 AUTHOR: mk@freeshell.de
494 With version 1.10 dsbmd now uses sysutils/fusefs-jmtpfs for mounting
495 MTP devices. Please adjust your dsbmd.conf or recreate it from the new
499 AFFECTS: multimedia/libva-intel-media-driver
500 AUTHOR: jbeich@FreeBSD.org
502 As of libva 2.6.0 iHD driver is automatically enabled, so you no
503 longer need to adjust LIBVA_DRIVER_NAME in ~/.profile or ~/.login.
506 AFFECTS: users of misc/openhab2
507 AUTHOR: netchild@FreeBSD.org
509 If you upgrade from a pevious version, make a backup of
511 read about the breaking changes in the release notes at
512 https://github.com/openhab/openhab-distro/releases/tag/2.5.0
514 %%PREFIX%%/libexec/openhab2/runtime/bin/update.freebsd
515 which takes care about changes for:
516 - Textual Configuration
517 - Next Generation Rule Engine
520 AFFECTS: users of python
521 AUTHOR: antoine@FreeBSD.org
523 Default version of python3 and python was switched to 3.7.
525 For ports users wanting to keep version 3.6 as default,
526 add DEFAULT_VERSIONS+= python=3.6 python3=3.6 to make.conf
528 This may ease the upgrade for users of pre-build packages:
530 # for i in $(pkg query -g %n 'py36-*'); do pkg set -yn ${i}:py37-${i#py36-}; done
533 For portmaster users:
535 # portmaster -o lang/python37 python36
536 # REINSTALL="$(pkg info -o py36-\* | awk '{printf "%s ", $2}')"
537 # pkg delete -f py36-\*
538 # portmaster $REINSTALL
539 # REBUILD=$(pkg query -g "%n:%dn" '*' | grep py3 | grep -v py37 | cut -d : -f 1 | sort -u)
540 # portmaster $REBUILD
541 # REBUILD2=$(pkg list | grep python-36 | xargs pkg which | awk '{print $6}' | sort -u)
542 # portmaster $REBUILD2
545 AFFECTS: users of mail/nextcloud-mail
546 AUTHOR: brnrd@FreeBSD.org
548 Version 0.20.0 removed the default mail configuration via config.php.
549 All users will be prompted to enter account and SMTP- and IMAP-server
550 details for sending and reading email.
553 AFFECTS: consumers of net/py-urllib3
554 AUTHOR: kai@FreeBSD.org
556 Since version 1.25 HTTPS connections are now verified by default which is
557 done via "cert_reqs = 'CERT_REQUIRED'". While certificate verification
558 can be disabled via "cert_reqs = 'CERT_NONE'", it's highly recommended to
561 Various consumers of net/py-urllib3 already have implemented routines that
562 either explicitly enable or disable HTTPS certificate verification (e.g.
563 via configuration settings, CLI arguments, etc.).
565 Yet it may happen that there are still some consumers which don't
566 explicitly enable/disable certificate verification for HTTPS connections
567 which could then lead to errors (as is often the case with self-signed
570 In case of an error one should try first to temporarily disable
571 certificate verification of the problematic urllib3 consumer to see if
572 this approach will remedy the issue.
575 AFFECTS: users of emulators/qemu
576 AUTHOR: bofh@FreeBSD.org
578 emulators/qemu31 has been updated to 4.1.1. Previous 3.1.X branch has
579 been repocopied to emulators/qemu31. If someone wants to stick with 3.1.X
580 branch please use one of the following command:
582 # pkg install emulators/qemu31
584 # portmaster -o emulators/qemu31 emulators/qemu
586 # portupgrade -o emulators/qemu31 emulators/qemu
589 AFFECTS: users of irc/eggdrop
590 AUTHOR: dbaio@FreeBSD.org
592 The irc/eggdrop port has been updated to 1.8.4 and its config is not
593 backward compatible with 1.6.21. A new port was created to keep 1.6.21
594 version available at irc/eggdrop16 and it will be available for 3 months
595 until users have time to upgrade their configuration.
598 https://raw.githubusercontent.com/eggheads/eggdrop/v1.8.4/NEWS
600 If you would like to keep using 1.6.21, please run the following command
601 to update pkg database:
603 pkg set -n eggdrop:eggdrop16
604 pkg set -o irc/eggdrop:irc/eggdrop16
607 AFFECTS: users of databases/redis[-devel]
608 AUTHOR: osa@FreeBSD.org
610 The databases/redis port has been updated to the recent stable release.
611 Users wanting to stay on v4.x can replace databases/redis with
612 databases/redis4 with one of the following commands:
614 # pkg install databases/redis4
616 # portmaster -o databases/redis4 databases/redis
618 # portupgrade -o databases/redis4 databases/redis
621 AFFECTS: users of www/node
622 AUTHOR: bhughes@FreeBSD.org
624 The www/node port has been updated to Node.js v13.0.0, the latest
625 upstream release. A new port, www/node12, has been created for the
626 v12.x LTS branch. Users wanting to stay on v12.x can replace www/node
627 with www/node12 with one of the following commands:
629 # pkg install www/node12
631 # portmaster -o www/node12 www/node
633 # portupgrade -o www/node12 www/node
636 AFFECTS: users of emulators/open-vm-tools[-nox11]
637 AUTHOR: jpaetzel@FreeBSD.org
639 open-vm-tools 11.0.1 has removed the vmxnet driver. This driver has been
640 in tree for quite some time and hopefully everyone is using the in tree
641 version, however if you had removed device vmx from your kernel, or are
642 running an unsupported version of FreeBSD which didn't have the driver
643 included in the base system, updating your open-vm-tools version will
644 leave you without networking.
647 AFFECTS: users of www/qt5-webengine
648 AUTHOR: kai@FreeBSD.org
650 Users that upgrade www/qt5-webengine without using pkg/poudriere might
651 experience failures due to conflicts with the installed version of 5.12.2.
653 In that case, pkg delete -f the qt5-webengine package before building
657 AFFECTS: users of x11/nvidia-driver (and slave ports)
658 AUTHOR: danfe@FreeBSD.org
660 x11/nvidia-driver* ports no longer install Linux programs and libraries,
661 which had been moved to their own ports (x11/linux-nvidia-libs*). When
662 updating the driver package next time, remember to install them manually
663 if you need to run Linux OpenGL programs.
666 AFFECTS: users of KDE Plasma Desktop (x11/plasma5*)
667 AUTHOR: kde@FreeBSD.org
669 With Plasma 5.17 the startup script has been renamed. People who use the
670 .xinitrc method to start Plasma have to call the new binary.
673 exec ck-launch-session startkde
675 exec ck-launch-session startplasma-x11
678 AFFECTS: users of mail/rspamd, mail/rspamd-devel
679 AUTHOR: vsevolod@FreeBSD.org
681 Sample configuration files has been removed as default configuration files
682 are NOT intended for modification by users and SHOULD be overwritten on
685 Make sure the default configuration files are unmodified and migrate all
686 configuration changes to the proper places, before you continue.
689 AFFECTS: users of textproc/groff
690 AUTHOR: bapt@FreeBSD.org
692 with groff 1.2.4_3, groff does not depend anymore on ghostscript and
693 netpbm. In order to be able to properly use the html backend the user
694 can install ghostscript and netpbm from ports without the need of
695 reinstalling the package.
697 Also note that the X11 option has been removed.
700 AFFECTS: users of net-mgmt/netbox
701 AUTHOR: kai@FreeBSD.org
703 Since the 2.6 release a running Redis server instance is required for
704 caching objects to run. Also the following settings like below need to be
705 added (or modified) in the existing configuration.py:
713 'DEFAULT_TIMEOUT': 300,
717 Note that if you were using these settings in a prior release with
718 webhooks, the DATABASE setting remains the same but an additional
719 CACHE_DATABASE settings has been added with a default value of 1 to
720 support the caching backend.
722 The DATABASE setting will be renamed in a future release of NetBox to
723 better relay the meaning of the setting. It is highly recommended to keep
724 the webhook and cache databases separate. Using the same database number
725 for both may result in webhook processing data being lost during cache
728 Please also check the pkg-message and the changelogs for further info.
731 AFFECTS: users of emulators/qemu-devel
732 AUTHOR: bofh@FreeBSD.org
734 qemu-devel has been updated to 4.1.0 and 4.0.0 has been merged into a new port
735 emulators/qemu40. If you want to stick with 4.0.X branch, simply use:
736 # portmaster -o emulators/qemu-devel emulators/qemu40
739 AFFECTS: users of XFCE desktop (x11-wm/xfce4)
740 AUTHOR: madpilot@FreeBSD.org
742 Due to changes in the XFCE 4.14 metaport, systems could end up with
743 both xscreensaver and xfce4-screensaver installed and enabled
746 This can cause conflicts and problems unlocking the screen.
748 To avoid problems, please make sure to have only one enabled by
749 going to the Application Autostart tab of the Session and Startup
750 settings applet and enable only one Screensaver there.
752 Some further information can be found in the xfce4-session
753 pkg-message displayed on installation and upgrade.
756 AFFECTS: users of net-mgmt/pushgateway
757 AUTHOR: 0mp@FreeBSD.org
759 The persistent storage format used by pushgateway in the latest version
760 is not backwards compatible. See the pushgateway changelogs for details.
763 AFFECTS: users of security/bastillion
764 AUTHOR: netchild@FreeBSD.org
766 The datastore of bastillion needs to be updated:
767 java -jar $PREFIX/jetty_bastillion/upgrade/bastillion-upgrade-3.08.00.jar \
768 $PREFIX/jetty_bastillion/bastillion/WEB-INF/classes/BastillionConfig.properties
771 AFFECTS: users of lang/ruby25
772 AUTHOR: mfechner@FreeBSD.org
774 The default ruby version has been updated from 2.5 to 2.6.
776 If you compile your own ports you may keep 2.5 as the default version by
777 adding the following lines to your /etc/make.conf file:
780 # Keep ruby 2.5 as default version
782 DEFAULT_VERSIONS+=ruby=2.5
784 If you wish to update to the new default version, you need to first stop any
785 software that uses ruby. Then, you will need to follow these steps, depending
786 upon how you manage your system.
788 If you use pkgng, simply upgrade:
791 If you do not use pkg, please check entry 20190420.
792 The description there should also work for this version.
795 AFFECTS: users of devel/py-fabric
796 AUTHOR: dbaio@FreeBSD.org
798 Fabric (devel/py-fabric) was upgraded to 2.5.0, Fabric (2+) represents
799 a near-total reimplementation and reorganization of the software.
801 Fabric 2 is not at 100% feature parity with 1.x! Some features have been
802 explicitly dropped, but others simply have not been ported over yet,
803 either due to time constraints or because said features need to be
804 re-examined in a modern context.
807 https://www.fabfile.org/upgrading.html#upgrading
808 https://www.fabfile.org/upgrading.html#upgrade-specifics
810 If you would like to keep using 1.x, please run the following command to
813 pkg set -n py27-fabric:py27-fabric1
814 pkg set -o devel/py-fabric:devel/py-fabric1
817 AFFECTS: users of www/gitlab-ce
818 AUTHOR: mfechner@FreeBSD.org
820 Make sure you upgrade your PostgreSQL to version 11 as described in 20190829,
821 before you upgrade your gitlab-ce version.
822 Gitlab-ce 12.1 needs at least PostgreSQL version 9.6.
824 After this you can follow the usual upgrade guide:
825 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/12.0-12.1-freebsd.md
828 AFFECTS: users of database/postgresql* and other software using PostgreSQL to run
829 AUTHOR: tz@FreeBSD.org
831 The default version of PostgreSQL has been switched from 9.5 to 11.
832 The upgrade procedure can use up twice the space the databases
833 currently needs. If you have a big amount of stored data take a
834 closer look at the manpage of pg_upgrade for avoidance and/or
835 speedup of the upgrade.
837 The upgrade instructions consider a basic usage and do not match
838 complex scenarios like replication, sharding, or similar.
840 Upgrade instructions:
842 First stop your PostgreSQL, create PostgreSQL-binaries and backup your data.
843 If you have another Version of PostgreSQL installed, for example 9.5.19, your
844 files are named according to this.
846 # service postgresql stop
847 # pkg create postgresql95-server postgresql95-contrib
848 # mkdir /tmp/pg-upgrade
849 # tar xf postgresql95-server-9.5.19.txz -C /tmp/pg-upgrade
850 # tar xf postgresql95-contrib-9.5.19.txz -C /tmp/pg-upgrade
851 # pkg delete -f databases/postgresql95-server databases/postgresql95-contrib databases/postgresql95-client
853 Now update PostgreSQL:
856 # pkg install databases/postgresql11-server databases/postgresql11-contrib
860 # portmaster databases/postgresql11-server databases/postgresql11-contrib
864 # portinstall databases/postgresql11-server databases/postgresql11-contrib
867 After installing the new PostgreSQL version you need to convert
868 all your databases to new version:
870 # su -l postgres -c "/usr/local/bin/initdb --encoding=utf-8 --lc-collate=C -D /var/db/postgres/data11 -U pgsql"
871 # chown -R postgres /usr/local/pgsql/data/
872 # 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 "
874 Now the migration is finished. You can start PostgreSQL again with:
876 # service postgresql start
879 1) The default user changed from "pgsql" to "postgres". The migration steps above preserve
880 the "pgsql" database user while the database daemon is now executed as the "postgres" FreeBSD user.
881 2) The default data dir changed from "/usr/local/pgsql/data/" to "/var/db/postgres/data11/"
882 3) If you use non-default initdb options, you have to adjust the initdb-command accordingly
885 AFFECTS: users of net-im/ejabberd
886 AUTHOR: ashish@FreeBSD.org
888 Riak support has been removed by upstream. For update instructions from
889 19.05, please refer to:
891 https://docs.ejabberd.im/admin/upgrade/from_19.05_to_19.08/
894 AFFECTS: users of lang/perl5*
895 AUTHOR: mat@FreeBSD.org
897 The default Perl version has been switched to Perl 5.30. If you are using
898 binary packages to upgrade your system, you do not have anything to do, pkg
899 upgrade will do the right thing. For the other people, follow the
900 instructions in entry 20161103, it should still be the same.
903 AFFECTS: users of www/ot-recorder
904 AUTHOR: dvl@FreeBSD.org
906 The data directory has moved from /var/spool/owntracks to
909 Be sure to stop otrecorder, move the directory, and start otrecorder.
911 service ot-recorder stop
914 service ot-recorder start
917 AFFECTS: users of net-im/py-matrix-synapse
918 AUTHOR: kai@FreeBSD.org
920 The support for Python 2.7 has been dropped with the 1.1.0 release of
921 net/py-matrix-synapse.
923 Users that still use the Python 2.7 version of net-im/py-matrix-synapse
924 should switch to a newer Python version, e.g. 3.6, which is the default
925 Python version since April 2019.
928 AFFECTS: users of net-p2p/zetacoin and net-p2p/zetacoin-nox11
929 AUTHOR: daniel@morante.net
931 Zetacoin will default to using modern versions of BDB (5.x or 6.x) when
932 the WALLET option is selected. See pkg-help for explanation.
934 The zetacoin-nox11 slave port was renamed to zetacoin-daemon to align
935 with the net-p2p/bitcoin format.
937 The zetacoin-cli and zetacoin-tx utilities have been re-packaged into
938 a separate port. If you require these programs, or use the zetacoin-cli
939 program to access the daemon or the GUI, install net-p2p/zetacoin-utils
943 AFFECTS: users of sysutils/py-borgmatic
944 AUTHOR: egypcio@FreeBSD.org
946 The default location for borgmatic's configurations changed. We moved it
947 from '/etc/borgmatic' to '/usr/local/etc/borgmatic' in order to follow
948 recommended standards used on FreeBSD.
951 AFFECTS: users with DEFAULT_VERSIONS+=linux=c6 or c6_64 in /etc/make.conf
952 AUTHOR: tijl@FreeBSD.org
954 On amd64 adding DEFAULT_VERSIONS+=linux=c6 to /etc/make.conf made Linux
955 infrastructure ports (linux_base-c6 and linux-c6*) install i386 CentOS 6
956 packages. Using c6_64 instead of c6 made them install mixed amd64/i386
957 CentOS 6 packages and allowed Linux application ports to install amd64
958 binaries when available. The i386-only configuration was only useful for
959 users of x11/nvidia-driver* which didn't provide Linux amd64 emulation
962 With x11/nvidia-driver* now supporting Linux amd64 there's no longer a
963 need for i386-only Linux on amd64 so DEFAULT_VERSIONS+=linux=c6 has been
964 changed to make Linux infrastructure ports install mixed amd64/i386
965 CentOS 6 packages, like c6_64 before, and support for c6_64 has been
968 Users with DEFAULT_VERSIONS+=linux=c6 should reinstall linux_base-c6 and
969 all packages that depend on it. A list of dependent packages can be
970 obtained with the following command:
972 pkg info -r linux_base-c6
974 Users with DEFAULT_VERSIONS+=linux=c6_64 only need to replace c6_64 with
975 c6 in /etc/make.conf.
977 Users of x11/nvidia-driver* should upgrade to FreeBSD 11.3 or 12.0 if
978 they want to run Linux amd64 OpenGL programs. If you are running an
979 older version you may want to postpone installing or updating Linux
980 application ports until you find the time to upgrade because application
981 ports may install amd64 binaries now. Infrastructure ports are safe to
982 reinstall, and so is x11/nvidia-driver*.
984 On i386 nothing has changed.
987 AFFECTS: users of www/gitlab-ce
988 AUTHOR: mfechner@FreeBSD.org
990 You must at first upgrade to version 11.11.5 before you can upgrade
992 Support for MySQL will be dropped with next version.
993 Make sure you use at least PostgreSQL version 9.6.
994 Follow the normal upgrade manual that can be found here:
995 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/11.11-12.0-freebsd.md
998 AFFECTS: users of net/serviio which bought a license for the non-free features
999 AUTHOR: netchild@FreeBSD.org
1001 Version 2 of serviio needs a new license file. Updating without a new license
1002 file will disable the non-free features.
1005 AFFECTS: users of databases/mysql56-(server|client)
1006 AUTHOR: ale@FreeBSD.org
1008 The default MySQL version has been updated from 5.6 to 5.7.
1010 If you compile your own ports you may keep 5.6 as the default version by
1011 adding the following lines to your /etc/make.conf file:
1014 # Keep MySQL 5.6 as default version
1016 DEFAULT_VERSIONS+=mysql=5.6
1018 If you wish to update to the new default version, you need to first stop any
1019 running server instance. Then, you will need to follow these steps, depending
1020 on installed packages.
1022 # pkg set -o databases/mysql56-client:databases/mysql57-client
1023 # pkg set -o databases/mysql56-server:databases/mysql57-server
1027 AFFECTS: users of net/samba410
1028 AUTHOR: timur@FreeBSD.org
1030 If you used Samba in AD/DC mode with the previous versions of the port on UFS2
1031 backed storage you have to add usage of vfs_freebsd VFS module for at least
1032 SYSVOL share and configure it to use 'legacy' mode(see manpage).
1034 The reason behind this is that previous versions Samba port used a hack to
1035 workaround broken mapping of Linux security and trusted extended attributes
1036 into FreeBSD namespace. In particular, essential security.NTACL attribute
1037 was replaced with the user.NTACL and placed in a insecure USER namespace.
1039 This port dropped this hack in favor of vfs_freebsd module, which should
1040 provide more controlled way of such a mapping.
1042 To maintain the compatibility with the previous installations on UFS2 storage
1043 (as ZFS uses it's own way of mapping SYSVOL, thanks to the iXsystems patches)
1044 the vfs_freebsd module provides 'legacy' mode that implements old functionality.
1046 For the fresh installations it is recommended to use 'secure' mode of operations
1047 for this module and use it as a global vfs objects.
1049 Caution: The given module is still considered EXPERIMENTAL.
1052 AFFECTS: users of net/samba410, net/samba4[6-8] and devel/talloc?, devel/tevent?, databases/tdb?, databases/ldb*
1053 AUTHOR: timur@FreeBSD.org
1055 The port of the new version of Samba 4.10 is introduced. Due necessarily
1056 to keep backwards compatibility for the legacy samba4[6-8] ports the
1057 upgrade procedure is a bit convoluted.
1059 You are safe to perform fresh new install of samba410 port. In case you
1060 are upgrading from the previous versions of Samba, please use the
1061 following procedure:
1063 0. Take backups of all the relevant files, in particular PREFIX/etc/smb4.conf
1064 and /var/db/samba4/ subdirectory. Keep in mind that files there (may)
1065 have extended attributes, so use appropriate tools to preserve them.
1067 1a. If you haven't updated Samba between 20190619 and 20190630 then next
1068 step should be as simple as:
1070 portmaster -o net/samba410 net/samba48
1072 1b. If you have been affected by the archiving legacy versions of
1073 Samba-related libraries for legacy versions of Samba, which happened
1074 in the given time frame, then you need to reverse operation from the
1077 for users of portmaster:
1078 portmaster -o devel/talloc devel/talloc1
1079 portmaster -o devel/tevent devel/tevent1
1080 portmaster -o databases/tdb databases/tdb1
1081 portmaster -o net/samba410 net/samba48
1083 for users of portupgrade:
1084 portupgrade -o devel/talloc devel/talloc1
1085 portupgrade -o devel/tevent devel/tevent1
1086 portupgrade -o databases/tdb databases/tdb1
1087 portupgrade -o net/samba410 net/samba48
1090 AFFECTS: users of samba4[6-8] and devel/talloc, devel/tevent, databases/tdb, databases/ldb*
1091 AUTHOR: timur@FreeBSD.org
1093 To introduce samba410(we deliberately skip samba49 due the complexity of handling)
1094 and to drop dependency on deprecated Python 2.7, Samba supplementary libraries
1095 talloc, tevent and tdb were split into current Python 3 compatible versions
1096 and legacy ones, with the suffix "1".
1098 Old versions of Samba were changed to depend on the legacy supplementary libraries,
1099 so if you need to install samba46, samba47 or samba48 over previous Samba
1100 installations you need to downgrade supplementary libs with the following commands:
1102 for users of portmaster:
1103 portmaster -o devel/talloc1 devel/talloc
1104 portmaster -o devel/tevent1 devel/tevent
1105 portmaster -o databases/tdb1 databases/tdb
1106 portmaster -r talloc1
1108 for users of portupgrade:
1109 portupgrade -o devel/talloc1 devel/talloc
1110 portupgrade -o devel/tevent1 devel/tevent
1111 portupgrade -o databases/tdb1 databases/tdb
1112 portupgrade -fr devel/talloc1
1115 AFFECTS: users of www/qt5-webengine
1116 AUTHOR: kai@FreeBSD.org
1118 Users that upgrade www/qt5-webengine without using pkg/poudriere might
1119 experience failures due to conflicts with the installed version of 5.12.2.
1121 In that case, pkg delete -f the qt5-webengine package before building
1122 the updated version.
1125 AFFECTS: users of net/routinator
1126 AUTHOR: rodrigo@FreeBSD.org
1128 Release 0.4.0 fundamentally changes the command line options for
1129 running the server and introduces a new way to initialize the local RPKI
1130 repository used by Routinator.
1131 If you have been using previous releases, you will likely have to adjust
1132 your tooling. We apologize for this, but we also feel that the new commands
1133 are more intuitive and logical.
1136 AFFECTS: users of net/samba47
1137 AUTHOR: antoine@FreeBSD.org
1139 The default version of samba has been switched from 4.7 to 4.8.
1140 Upgrade instructions:
1142 For package users having samba47 installed indirectly (as a dependency):
1145 For package users having samba47 installed directly (leaf port):
1147 # pkg install samba48
1150 If you want to keep samba47, add DEFAULT_VERSIONS+= samba=4.7 to make.conf
1152 If you want to upgrade to samba48, remove samba47:
1153 # pkg delete -f samba47
1156 # portmaster net/samba48
1160 # portinstall net/samba48