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 security/openssh-portable
10 AUTHOR: bdrewery@FreeBSD.org
12 OpenSSH was upgraded to 8.2p1 on 2020-03-23.
14 A restart of sshd is required after upgrade due to an incompatibility
17 Please see https://www.openssh.com/txt/release-8.2 for upcoming
21 AFFECTS: users of net/irrd
22 AUTHOR: bofh@FreeBSD.org
24 Legacy version of net/irrd has been moved to net/irrd-legacy.
25 net/irrd has been upgraded to 4.X branch. If someone wants to stick with
26 legacy version then pkg users have to do something like
28 # pkg set -o net/irrd:net/irrd-legacy
31 # portmaster -o net/irrd-legacy net/irrd
33 Both of the version can be installed and used concurrently in case there is
37 AFFECTS: users of x11-fonts/fontconfig
38 AUTHOR: desktop@FreeBSD.org
40 Fontconfig 2.13.1 generated .uuid files in the fonts directory which where
41 not properly registered to the packages. To clean them up, please execute the
44 find /usr/local/share/fonts -type f -name .uuid -delete
47 AFFECTS: users of devel/sonarqube and devel/sonar-ant-task
48 AUTHOR: netchild@FreeBSD.org
50 The outdated port devel/sonarqube has moved to
51 devel/sonarqube-community to make it clear that it is the community
52 edition. The log and DB files are still stored in the same location.
54 The devel/sonar-ant-task port has moved to devel/sonarqube-ant-task
55 to match the upstream-name. The install location is renamed
58 At the same time the user/group of the sonarqube port changed from
59 www:www to sonarqube:sonarqube.
61 It is expected that nobody was using the 6.2 version from 2016
62 anymore and no change needs to be done. No analysis was done to check
63 if the old 6.2 version can be updated in-place to the 8.2 version.
64 As such if there is still someone using the old 6.2 version, you may
65 have to delete /var/log/sonarqube and /var/db/sonarqube before
66 installing the new version.
69 AFFECTS: users of devel/qca
70 AUTHOR: kde@FreeBSD.org
72 New versions of devel/qca stopped supporting OpenSSL < 1.1.
73 For this reason devel/qca-legacy has been added, which is
74 held back at an older version until FreeBSD 11 goes EOL.
76 Ports depending on devel/qca should stop adding direct LIB_DEPENDS
77 and switch to depending on it via USES=qca.
79 FreeBSD 11 users might want to run something like
81 pkg set -o devel/qca:devel/qca-legacy
84 AFFECTS: users of x11/libxkbcommon
85 AUTHOR: zeising@FreeBSD.org
87 The libxkbcommon library (x11/libxkbcommon), used to handle keyboards
88 in some applications, most notably kde and wayland, have been switched
89 to use evdev rules by default on FreeBSD 12 and later. Some keys, most
90 notably arrow keys, may not work in applications using libxkbcommon if
91 you are using xf86-input-keyboard rather than xf86-input-libinput.
92 If you have trouble with the keyboard keys, and if /var/log/Xorg.*.log
93 shows that the "kbd" or "keyboard" driver is being used, you need to
94 switch to legacy rules by setting the environment variable
95 XKB_DEFAULT_RULES to xorg.
96 This switch is made to match the default configuration on FreeBSD 12.1 and
97 later, the default configuration on FreeBSD 11.3 still uses the legacy
101 AFFECTS: users of net-im/slack-term
102 AUTHOR: dmgk@FreeBSD.org
104 The config file location was changed from ~/.slack-term to
105 ~/.config/slack-term/config, please move your existing config file
109 AFFECTS: users of graphics/mesa-libs and legacy graphics drivers
110 AUTHOR: zeising@FreeBSD.org
112 The mesa OpenGL library (graphics/mesa-libs) has been switched to use DRI3
113 by default, instead of the older DRI2 interface. This might cause regressions
114 when using the legacy graphics drivers, either through
115 graphics/drm-legacy-kmod or the graphics drivers in base.
117 If you experience issues when running OpenGL applications it is possible
118 to force the use of DRI2 by setting the LIBGL_DRI3_DISABLE environment
119 variable to 1 before starting any OpenGL application. The easiest way to
120 do this is by adding it to either your shell startup files or .xinitrc.
123 AFFECTS: users of databases/mysql80-server
124 AUTHOR: joneum@FreeBSD.org
126 As of MySQL 8.0.16, the MySQL server performs the upgrade tasks previously
127 handled by mysql_upgrade. Consequently, mysql_upgrade is unneeded and is
128 deprecated as of that version, and will be removed in a future MySQL version.
129 Because mysql_upgrade no longer performs upgrade tasks,
130 it exits with status 0 unconditionally.
133 AFFECTS: users of net-mgmt/librenms
134 AUTHOR: dvl@FreeBSD.org
136 1. Apache / mod_php options removed
138 The APACHEMOD option has been removed. LibreNMS can be used
139 with other webservers, not just Apache. In order to simplify
140 the port, the option was removed.
142 Now you manually install the webserver of your preference.
144 If upgrading from LibreNMS < 1.61, you can do this to
145 prevent 'pkg autoremove' from uninstalling Apache / mod_php:
147 $ sudo pkg set -A 0 apache24 mod_php74
148 Mark apache24-2.4.41 as not automatically installed? [y/N]: y
149 Mark mod_php74-7.4.3 as not automatically installed? [y/N]: y
151 Adjust mod_php74 to suit the version of mod_php you have.
153 2. include/defaults.inc.php is gone
155 The file include/defaults.inc.php is no longer distributed by
156 the upstream project. The FreeBSD port patched this file to
157 correct the paths to common tools such as ping, snmpwalk, etc.
159 These values previously adjusted by the port must now be specified
160 in config.php. New installs will have this automatically, but existing
161 installs must be updated manually. These are the entries you should
162 add if upgrading from LibreNMS < 1.61:
164 $config['snmpwalk'] = '/usr/local/bin/snmpwalk';
165 $config['snmpget'] = '/usr/local/bin/snmpget';
166 $config['snmpbulkwalk'] = '/usr/local/bin/snmpbulkwalk';
167 $config['snmptranslate'] = '/usr/local/bin/snmptranslate';
169 $config['ping'] = '/sbin/ping';
170 $config['mtr'] = '/usr/local/bin/mtr';
171 $config['nmap'] = '/usr/local/bin/nmap';
173 $config['nagios_plugins'] = '/usr/local/libexec/nagios';
174 $config['ipmitool'] = '/usr/local/bin/ipmitool';
175 $config['virsh'] = '/usr/local/bin/virsh';
176 $config['dot'] = '/usr/local/bin/dot';
177 $config['sfdp'] = '/usr/local/bin/sfdp';
178 $config['nfdump'] = '/usr/local/bin/nfdump';
181 AFFECTS: users of textproc/apache-solr
182 AUTHOR: mfechner@FreeBSD.org
184 Apache-solr switched to the supported java LTS version 11.
185 Make sure you update the following files accordingly:
186 /usr/local/etc/solr.in.sh (see /usr/local/etc/solr.in.sh.sample)
187 /usr/local/etc/javavm_opts.conf (JAVA_HOME=/usr/local/openjdk11/)
190 AFFECTS: users of net-mgmt/netbox
191 AUTHOR: kai@FreeBSD.org
193 1. Removal of the Topology Maps feature
195 The deprecated topology maps feature has been removed. Please replicate
196 any required data to another source before upgrading NetBox to v2.7.7, as
197 any existing topology maps will be deleted.
200 2. Changed REDIS database configuration settings
202 The REDIS database configuration parameters were splitted up in two
203 discrete subsections named "webhooks" and "caching" with the 2.7 release.
204 This requires modification of the REDIS parameter in configuration.py as
207 Old Redis sample configuration:
215 'DEFAULT_TIMEOUT': 300,
219 New Redis sample configuration:
223 'HOST': 'redis.example.com',
225 'PASSWORD': 'foobar',
227 'DEFAULT_TIMEOUT': 300,
235 'DEFAULT_TIMEOUT': 300,
240 Note that the CACHE_DATABASE parameter has been removed and the connection
241 settings have been duplicated for both webhooks and caching. This allows
242 one to make use of separate Redis instances if desired. It is fine to use
243 the same Redis service for both functions, although the database
244 identifiers should be different.
246 Please also check the pkg-message and the changelogs for further info.
249 AFFECTS: users of security/gsasl
250 AUTHOR: hrs@FreeBSD.org
252 The library part of security/gsasl has been split into security/libgsasl.
253 The security/gsasl now depends on security/libgsasl. Due to this change,
254 old security/gsasl conflicts with the new security/libgsasl and it can
255 prevent the installed security/gsasl from upgrading. Please remove the
256 installed security/gsasl before upgrading if a conflict error occurs.
259 AFFECTS: users of x11-servers/xorg-server
260 AUTHOR: zeising@FreeBSD.org
262 x11-servers/xorg-server has been updated to 1.20.7.
264 With this update, xorg-server has switched from using the devd backend to
265 the udev backend for device configuration on FreeBSD 12 and 13. If you have
266 issues with input devices, please see the install message for details.
268 The HAL backend option has been completely removed, as it was deprecated.
270 If you have problems with input devices, ensure that both x11/libinput and
271 x11-drivers/xf86-input-libinput are installed. They are installed in the
272 default configuration, but if you have a custom configuration, they might not
276 AFFECTS: users of net-im/prosody
277 AUTHOR: thomas@beingboiled.info
279 Prosody's pid file and data directory have moved to a new location.
280 If you are upgrading from a version with the pid file and data
281 directory in /usr/local/var/lib/prosody please perform these steps:
284 pkill -F /usr/local/var/lib/prosody/prosody.pid
286 # copy the data directory
287 cp -a /usr/local/var/lib/prosody /var/db/prosody
288 rm -f /var/db/prosody/prosody.pid
290 Make sure your prosody config has the following option set:
292 pidfile = "/var/run/prosody/prosody.pid"
294 Then start Prosody again. Everything should be working as before and
295 the /usr/local/var/lib/prosody directory can now be removed.
298 AFFECTS: users of security/nss
299 AUTHOR: lwhsu@FreeBSD.org
301 NSS header files and libraries have been moved from ${PREFIX}/include/nss/nss
302 and ${PREFIX}/lib/nss to ${PREFIX}/include/nss and ${PREFIX}/lib
305 AFFECTS: users of editors/vim
306 AUTHOR: adamw@FreeBSD.org
308 The PYTHON2 and PYTHON3 options have been turned into a single PYTHON
309 option that uses whichever python you've set as default. However,
310 this means that you cannot have both python2 and python3 support at
314 AFFECTS: users of multimedia/gstreamer1-plugins[-bad]
315 AUTHOR: kwm@freebsd.org
317 In GStreamer 1.16 some files moved from the gstreamer1-plugins-bad package
318 to the gstreamer1-plugins package.
320 If your using a tool like portmaster or portupgrade delete the old -bad
321 port and then follow the normal upgrade method.
322 # pkg delete -f gstreamer1-plugins-bad
325 AFFECTS: users of sysutils/helm
326 AUTHOR: danilo@FreeBSD.org
328 The Helm project have deprecated the Tiller utility in Helm 3. If you are using
329 Helm 2 you will need to migrate the configuration to be compatible with Helm 3.
330 Please, refer to the following documentation for more information about the
333 https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/
335 Note that the 2to3 plugin binary is not available for FreeBSD and you will need
336 to compile it yourself.
339 AFFECTS: users of python and net/samba410, devel/talloc, devel/tevent, databases/tdb, databases/ldb*
340 AUTHOR: timur@FreeBSD.org
342 In the entry 20191216 for the Python update the filtering constrains
343 are too limiting and omit the Samba supplimentary libraries, which do
344 have Python bindings to the default Python 3.x version. With the update
345 of the default Python3 version you also need to rebuild all the
346 supplimentary Samba libraries and samba410 itself.
348 For portmaster users it would be enough to run:
350 # portmaster devel/talloc devel/tevent databases/tdb databases/ldb15 net/samba410
355 AUTHOR: gecko@FreeBSD.org
357 Firefox requires Capsicum since r522464 for IPC and in future will
358 require Capsicum for process sandboxing. If you use a custom kernel
359 make sure to copy the following lines from GENERIC kernel:
361 options CAPABILITY_MODE # Capsicum capability mode
362 options CAPABILITIES # Capsicum capabilities
365 AFFECTS: Users of *-emacs27-* packages
366 AUTHOR: ashish@FreeBSD.org
368 There is a major version bump in 28.0.50, therefore to upgrade all the
369 packages dependent on editors/emacs-devel, please use the following commands:
372 # for i in $(pkg query -g %n '*-emacs27*'); do \
373 nn=$(echo "$i" | sed -e 's/emacs27/emacs28/'); \
374 pkg set -yn "$i":"$nn"; done;
378 AFFECTS: users of net/gnatsd
379 AUTHOR: olgeni@FreeBSD.org
381 net/gnatsd has been replaced by net/nats-server to reflect the
384 All options in rc.conf should be renamed by replacing 'gnats'
385 with 'nats' (nats_enable, nats_user, nats_options).
388 AFFECTS: users of security/openssl and security/openssl111
389 AUTHOR: brnrd@FreeBSD.org
391 The openssl port was removed on 2019-12-31, subsequently the openssl111
392 port was renamed to openssl on 2020-01-01.
394 The shared library version of OpenSSL has been bumped.
396 Users of DEFAULT_VERSIONS= ssl=openssl111 must update this to
399 You must rebuild all ports that depend on OpenSSL if you use OpenSSL
403 AFFECTS: users of sysutils/dsbmd
404 AUTHOR: mk@freeshell.de
406 With version 1.10 dsbmd now uses sysutils/fusefs-jmtpfs for mounting
407 MTP devices. Please adjust your dsbmd.conf or recreate it from the new
411 AFFECTS: multimedia/libva-intel-media-driver
412 AUTHOR: jbeich@FreeBSD.org
414 As of libva 2.6.0 iHD driver is automatically enabled, so you no
415 longer need to adjust LIBVA_DRIVER_NAME in ~/.profile or ~/.login.
418 AFFECTS: users of misc/openhab2
419 AUTHOR: netchild@FreeBSD.org
421 If you upgrade from a pevious version, make a backup of
423 read about the breaking changes in the release notes at
424 https://github.com/openhab/openhab-distro/releases/tag/2.5.0
426 %%PREFIX%%/libexec/openhab2/runtime/bin/update.freebsd
427 which takes care about changes for:
428 - Textual Configuration
429 - Next Generation Rule Engine
432 AFFECTS: users of python
433 AUTHOR: antoine@FreeBSD.org
435 Default version of python3 and python was switched to 3.7.
437 For ports users wanting to keep version 3.6 as default,
438 add DEFAULT_VERSIONS+= python=3.6 python3=3.6 to make.conf
440 This may ease the upgrade for users of pre-build packages:
442 # for i in $(pkg query -g %n 'py36-*'); do pkg set -yn ${i}:py37-${i#py36-}; done
445 For portmaster users:
446 # portmaster -o lang/python37 python36
447 # REINSTALL="$(pkg info -o py36-\* | awk '{printf "%s ", $2}')"
448 # pkg delete -f py36-\*
449 # portmaster $REINSTALL
450 # REBUILD=$(pkg query -g "%n:%dn" '*' | grep py3 | grep -v py37 | cut -d : -f 1 | sort -u)
451 # portmaster $REBUILD
452 # REBUILD2=$(pkg list | grep python-36 | xargs pkg which | awk '{print $6}' | sort -u)
453 # portmaster $REBUILD2
456 AFFECTS: users of mail/nextcloud-mail
457 AUTHOR: brnrd@FreeBSD.org
459 Version 0.20.0 removed the default mail configuration via config.php.
460 All users will be prompted to enter account and SMTP- and IMAP-server
461 details for sending and reading email.
464 AFFECTS: consumers of net/py-urllib3
465 AUTHOR: kai@FreeBSD.org
467 Since version 1.25 HTTPS connections are now verified by default which is
468 done via "cert_reqs = 'CERT_REQUIRED'". While certificate verification
469 can be disabled via "cert_reqs = 'CERT_NONE'", it's highly recommended to
472 Various consumers of net/py-urllib3 already have implemented routines that
473 either explicitly enable or disable HTTPS certificate verification (e.g.
474 via configuration settings, CLI arguments, etc.).
476 Yet it may happen that there are still some consumers which don't
477 explicitly enable/disable certificate verification for HTTPS connections
478 which could then lead to errors (as is often the case with self-signed
481 In case of an error one should try first to temporarily disable
482 certificate verification of the problematic urllib3 consumer to see if
483 this approach will remedy the issue.
486 AFFECTS: users of emulators/qemu
487 AUTHOR: bofh@FreeBSD.org
489 emulators/qemu31 has been updated to 4.1.1. Previous 3.1.X branch has
490 been repocopied to emulators/qemu31. If someone wants to stick with 3.1.X
491 branch please use one of the following command:
493 # pkg install emulators/qemu31
495 # portmaster -o emulators/qemu31 emulators/qemu
497 # portupgrade -o emulators/qemu31 emulators/qemu
500 AFFECTS: users of irc/eggdrop
501 AUTHOR: dbaio@FreeBSD.org
503 The irc/eggdrop port has been updated to 1.8.4 and its config is not
504 backward compatible with 1.6.21. A new port was created to keep 1.6.21
505 version available at irc/eggdrop16 and it will be available for 3 months
506 until users have time to upgrade their configuration.
509 https://raw.githubusercontent.com/eggheads/eggdrop/v1.8.4/NEWS
511 If you would like to keep using 1.6.21, please run the following command
512 to update pkg database:
514 pkg set -n eggdrop:eggdrop16
515 pkg set -o irc/eggdrop:irc/eggdrop16
518 AFFECTS: users of databases/redis[-devel]
519 AUTHOR: osa@FreeBSD.org
521 The databases/redis port has been updated to the recent stable release.
522 Users wanting to stay on v4.x can replace databases/redis with
523 databases/redis4 with one of the following commands:
525 # pkg install databases/redis4
527 # portmaster -o databases/redis4 databases/redis
529 # portupgrade -o databases/redis4 databases/redis
532 AFFECTS: users of www/node
533 AUTHOR: bhughes@FreeBSD.org
535 The www/node port has been updated to Node.js v13.0.0, the latest
536 upstream release. A new port, www/node12, has been created for the
537 v12.x LTS branch. Users wanting to stay on v12.x can replace www/node
538 with www/node12 with one of the following commands:
540 # pkg install www/node12
542 # portmaster -o www/node12 www/node
544 # portupgrade -o www/node12 www/node
547 AFFECTS: users of emulators/open-vm-tools[-nox11]
548 AUTHOR: jpaetzel@FreeBSD.org
550 open-vm-tools 11.0.1 has removed the vmxnet driver. This driver has been
551 in tree for quite some time and hopefully everyone is using the in tree
552 version, however if you had removed device vmx from your kernel, or are
553 running an unsupported version of FreeBSD which didn't have the driver
554 included in the base system, updating your open-vm-tools version will
555 leave you without networking.
558 AFFECTS: users of www/qt5-webengine
559 AUTHOR: kai@FreeBSD.org
561 Users that upgrade www/qt5-webengine without using pkg/poudriere might
562 experience failures due to conflicts with the installed version of 5.12.2.
564 In that case, pkg delete -f the qt5-webengine package before building
568 AFFECTS: users of x11/nvidia-driver (and slave ports)
569 AUTHOR: danfe@FreeBSD.org
571 x11/nvidia-driver* ports no longer install Linux programs and libraries,
572 which had been moved to their own ports (x11/linux-nvidia-libs*). When
573 updating the driver package next time, remember to install them manually
574 if you need to run Linux OpenGL programs.
577 AFFECTS: users of KDE Plasma Desktop (x11/plasma5*)
578 AUTHOR: kde@FreeBSD.org
580 With Plasma 5.17 the startup script has been renamed. People who use the
581 .xinitrc method to start Plasma have to call the new binary.
584 exec ck-launch-session startkde
586 exec ck-launch-session startplasma-x11
589 AFFECTS: users of mail/rspamd, mail/rspamd-devel
590 AUTHOR: vsevolod@FreeBSD.org
592 Sample configuration files has been removed as default configuration files
593 are NOT intended for modification by users and SHOULD be overwritten on
596 Make sure the default configuration files are unmodified and migrate all
597 configuration changes to the proper places, before you continue.
600 AFFECTS: users of textproc/groff
601 AUTHOR: bapt@FreeBSD.org
603 with groff 1.2.4_3, groff does not depend anymore on ghostscript and
604 netpbm. In order to be able to properly use the html backend the user
605 can install ghostscript and netpbm from ports without the need of
606 reinstalling the package.
608 Also note that the X11 option has been removed.
611 AFFECTS: users of net-mgmt/netbox
612 AUTHOR: kai@FreeBSD.org
614 Since the 2.6 release a running Redis server instance is required for
615 caching objects to run. Also the following settings like below need to be
616 added (or modified) in the existing configuration.py:
624 'DEFAULT_TIMEOUT': 300,
628 Note that if you were using these settings in a prior release with
629 webhooks, the DATABASE setting remains the same but an additional
630 CACHE_DATABASE settings has been added with a default value of 1 to
631 support the caching backend.
633 The DATABASE setting will be renamed in a future release of NetBox to
634 better relay the meaning of the setting. It is highly recommended to keep
635 the webhook and cache databases separate. Using the same database number
636 for both may result in webhook processing data being lost during cache
639 Please also check the pkg-message and the changelogs for further info.
642 AFFECTS: users of emulators/qemu-devel
643 AUTHOR: bofh@FreeBSD.org
645 qemu-devel has been updated to 4.1.0 and 4.0.0 has been merged into a new port
646 emulators/qemu40. If you want to stick with 4.0.X branch, simply use:
647 # portmaster -o emulators/qemu-devel emulators/qemu40
650 AFFECTS: users of XFCE desktop (x11-wm/xfce4)
651 AUTHOR: madpilot@FreeBSD.org
653 Due to changes in the XFCE 4.14 metaport, systems could end up with
654 both xscreensaver and xfce4-screensaver installed and enabled
657 This can cause conflicts and problems unlocking the screen.
659 To avoid problems, please make sure to have only one enabled by
660 going to the Application Autostart tab of the Session and Startup
661 settings applet and enable only one Screensaver there.
663 Some further information can be found in the xfce4-session
664 pkg-message displayed on installation and upgrade.
667 AFFECTS: users of net-mgmt/pushgateway
668 AUTHOR: 0mp@FreeBSD.org
670 The persistent storage format used by pushgateway in the latest version
671 is not backwards compatible. See the pushgateway changelogs for details.
674 AFFECTS: users of security/bastillion
675 AUTHOR: netchild@FreeBSD.org
677 The datastore of bastillion needs to be updated:
678 java -jar $PREFIX/jetty_bastillion/upgrade/bastillion-upgrade-3.08.00.jar \
679 $PREFIX/jetty_bastillion/bastillion/WEB-INF/classes/BastillionConfig.properties
682 AFFECTS: users of lang/ruby25
683 AUTHOR: mfechner@FreeBSD.org
685 The default ruby version has been updated from 2.5 to 2.6.
687 If you compile your own ports you may keep 2.5 as the default version by
688 adding the following lines to your /etc/make.conf file:
691 # Keep ruby 2.5 as default version
693 DEFAULT_VERSIONS+=ruby=2.5
695 If you wish to update to the new default version, you need to first stop any
696 software that uses ruby. Then, you will need to follow these steps, depending
697 upon how you manage your system.
699 If you use pkgng, simply upgrade:
702 If you do not use pkg, please check entry 20190420.
703 The description there should also work for this version.
706 AFFECTS: users of devel/py-fabric
707 AUTHOR: dbaio@FreeBSD.org
709 Fabric (devel/py-fabric) was upgraded to 2.5.0, Fabric (2+) represents
710 a near-total reimplementation and reorganization of the software.
712 Fabric 2 is not at 100% feature parity with 1.x! Some features have been
713 explicitly dropped, but others simply have not been ported over yet,
714 either due to time constraints or because said features need to be
715 re-examined in a modern context.
718 https://www.fabfile.org/upgrading.html#upgrading
719 https://www.fabfile.org/upgrading.html#upgrade-specifics
721 If you would like to keep using 1.x, please run the following command to
724 pkg set -n py27-fabric:py27-fabric1
725 pkg set -o devel/py-fabric:devel/py-fabric1
728 AFFECTS: users of www/gitlab-ce
729 AUTHOR: mfechner@FreeBSD.org
731 Make sure you upgrade your PostgreSQL to version 11 as described in 20190829,
732 before you upgrade your gitlab-ce version.
733 Gitlab-ce 12.1 needs at least PostgreSQL version 9.6.
735 After this you can follow the usual upgrade guide:
736 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/12.0-12.1-freebsd.md
739 AFFECTS: users of database/postgresql* and other software using PostgreSQL to run
740 AUTHOR: tz@FreeBSD.org
742 The default version of PostgreSQL has been switched from 9.5 to 11.
743 The upgrade procedure can use up twice the space the databases
744 currently needs. If you have a big amount of stored data take a
745 closer look at the manpage of pg_upgrade for avoidance and/or
746 speedup of the upgrade.
748 The upgrade instructions consider a basic usage and do not match
749 complex scenarios like replication, sharding, or similar.
751 Upgrade instructions:
753 First stop your PostgreSQL, create PostgreSQL-binaries and backup your data.
754 If you have another Version of PostgreSQL installed, for example 9.5.19, your
755 files are named according to this.
757 # service postgresql stop
758 # pkg create postgresql95-server postgresql95-contrib
759 # mkdir /tmp/pg-upgrade
760 # tar xf postgresql95-server-9.5.19.txz -C /tmp/pg-upgrade
761 # tar xf postgresql95-contrib-9.5.19.txz -C /tmp/pg-upgrade
762 # pkg delete -f databases/postgresql95-server databases/postgresql95-contrib databases/postgresql95-client
764 Now update PostgreSQL:
767 # pkg install databases/postgresql11-server databases/postgresql11-contrib
771 # portmaster databases/postgresql11-server databases/postgresql11-contrib
775 # portinstall databases/postgresql11-server databases/postgresql11-contrib
778 After installing the new PostgreSQL version you need to convert
779 all your databases to new version:
781 # su -l postgres -c "/usr/local/bin/initdb --encoding=utf-8 --lc-collate=C -D /var/db/postgres/data11 -U pgsql"
782 # chown -R postgres /usr/local/pgsql/data/
783 # 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 "
785 Now the migration is finished. You can start PostgreSQL again with:
787 # service postgresql start
790 1) The default user changed from "pgsql" to "postgres". The migration steps above preserve
791 the "pgsql" database user while the database daemon is now executed as the "postgres" FreeBSD user.
792 2) The default data dir changed from "/usr/local/pgsql/data/" to "/var/db/postgres/data11/"
793 3) If you use non-default initdb options, you have to adjust the initdb-command accordingly
796 AFFECTS: users of net-im/ejabberd
797 AUTHOR: ashish@FreeBSD.org
799 Riak support has been removed by upstream. For update instructions from
800 19.05, please refer to:
802 https://docs.ejabberd.im/admin/upgrade/from_19.05_to_19.08/
805 AFFECTS: users of lang/perl5*
806 AUTHOR: mat@FreeBSD.org
808 The default Perl version has been switched to Perl 5.30. If you are using
809 binary packages to upgrade your system, you do not have anything to do, pkg
810 upgrade will do the right thing. For the other people, follow the
811 instructions in entry 20161103, it should still be the same.
814 AFFECTS: users of www/ot-recorder
815 AUTHOR: dvl@FreeBSD.org
817 The data directory has moved from /var/spool/owntracks to
820 Be sure to stop otrecorder, move the directory, and start otrecorder.
822 service ot-recorder stop
825 service ot-recorder start
828 AFFECTS: users of net-im/py-matrix-synapse
829 AUTHOR: kai@FreeBSD.org
831 The support for Python 2.7 has been dropped with the 1.1.0 release of
832 net/py-matrix-synapse.
834 Users that still use the Python 2.7 version of net-im/py-matrix-synapse
835 should switch to a newer Python version, e.g. 3.6, which is the default
836 Python version since April 2019.
839 AFFECTS: users of net-p2p/zetacoin and net-p2p/zetacoin-nox11
840 AUTHOR: daniel@morante.net
842 Zetacoin will default to using modern versions of BDB (5.x or 6.x) when
843 the WALLET option is selected. See pkg-help for explanation.
845 The zetacoin-nox11 slave port was renamed to zetacoin-daemon to align
846 with the net-p2p/bitcoin format.
848 The zetacoin-cli and zetacoin-tx utilities have been re-packaged into
849 a separate port. If you require these programs, or use the zetacoin-cli
850 program to access the daemon or the GUI, install net-p2p/zetacoin-utils
854 AFFECTS: users of sysutils/py-borgmatic
855 AUTHOR: egypcio@FreeBSD.org
857 The default location for borgmatic's configurations changed. We moved it
858 from '/etc/borgmatic' to '/usr/local/etc/borgmatic' in order to follow
859 recommended standards used on FreeBSD.
862 AFFECTS: users with DEFAULT_VERSIONS+=linux=c6 or c6_64 in /etc/make.conf
863 AUTHOR: tijl@FreeBSD.org
865 On amd64 adding DEFAULT_VERSIONS+=linux=c6 to /etc/make.conf made Linux
866 infrastructure ports (linux_base-c6 and linux-c6*) install i386 CentOS 6
867 packages. Using c6_64 instead of c6 made them install mixed amd64/i386
868 CentOS 6 packages and allowed Linux application ports to install amd64
869 binaries when available. The i386-only configuration was only useful for
870 users of x11/nvidia-driver* which didn't provide Linux amd64 emulation
873 With x11/nvidia-driver* now supporting Linux amd64 there's no longer a
874 need for i386-only Linux on amd64 so DEFAULT_VERSIONS+=linux=c6 has been
875 changed to make Linux infrastructure ports install mixed amd64/i386
876 CentOS 6 packages, like c6_64 before, and support for c6_64 has been
879 Users with DEFAULT_VERSIONS+=linux=c6 should reinstall linux_base-c6 and
880 all packages that depend on it. A list of dependent packages can be
881 obtained with the following command:
883 pkg info -r linux_base-c6
885 Users with DEFAULT_VERSIONS+=linux=c6_64 only need to replace c6_64 with
886 c6 in /etc/make.conf.
888 Users of x11/nvidia-driver* should upgrade to FreeBSD 11.3 or 12.0 if
889 they want to run Linux amd64 OpenGL programs. If you are running an
890 older version you may want to postpone installing or updating Linux
891 application ports until you find the time to upgrade because application
892 ports may install amd64 binaries now. Infrastructure ports are safe to
893 reinstall, and so is x11/nvidia-driver*.
895 On i386 nothing has changed.
898 AFFECTS: users of www/gitlab-ce
899 AUTHOR: mfechner@FreeBSD.org
901 You must at first upgrade to version 11.11.5 before you can upgrade
903 Support for MySQL will be dropped with next version.
904 Make sure you use at least PostgreSQL version 9.6.
905 Follow the normal upgrade manual that can be found here:
906 https://gitlab.fechner.net/mfechner/Gitlab-docu/blob/master/update/11.11-12.0-freebsd.md
909 AFFECTS: users of net/serviio which bought a license for the non-free features
910 AUTHOR: netchild@FreeBSD.org
912 Version 2 of serviio needs a new license file. Updating without a new license
913 file will disable the non-free features.
916 AFFECTS: users of databases/mysql56-(server|client)
917 AUTHOR: ale@FreeBSD.org
919 The default MySQL version has been updated from 5.6 to 5.7.
921 If you compile your own ports you may keep 5.6 as the default version by
922 adding the following lines to your /etc/make.conf file:
925 # Keep MySQL 5.6 as default version
927 DEFAULT_VERSIONS+=mysql=5.6
929 If you wish to update to the new default version, you need to first stop any
930 running server instance. Then, you will need to follow these steps, depending
931 on installed packages.
933 # pkg set -o databases/mysql56-client:databases/mysql57-client
934 # pkg set -o databases/mysql56-server:databases/mysql57-server
938 AFFECTS: users of net/samba410
939 AUTHOR: timur@FreeBSD.org
941 If you used Samba in AD/DC mode with the previous versions of the port on UFS2
942 backed storage you have to add usage of vfs_freebsd VFS module for at least
943 SYSVOL share and configure it to use 'legacy' mode(see manpage).
945 The reason behind this is that previous versions Samba port used a hack to
946 workaround broken mapping of Linux security and trusted extended attributes
947 into FreeBSD namespace. In particular, essential security.NTACL attribute
948 was replaced with the user.NTACL and placed in a insecure USER namespace.
950 This port dropped this hack in favor of vfs_freebsd module, which should
951 provide more controlled way of such a mapping.
953 To maintain the compatibility with the previous installations on UFS2 storage
954 (as ZFS uses it's own way of mapping SYSVOL, thanks to the iXsystems patches)
955 the vfs_freebsd module provides 'legacy' mode that implements old functionality.
957 For the fresh installations it is recommended to use 'secure' mode of operations
958 for this module and use it as a global vfs objects.
960 Caution: The given module is still considered EXPERIMENTAL.
963 AFFECTS: users of net/samba410, net/samba4[6-8] and devel/talloc?, devel/tevent?, databases/tdb?, databases/ldb*
964 AUTHOR: timur@FreeBSD.org
966 The port of the new version of Samba 4.10 is introduced. Due necessarily
967 to keep backwards compatibility for the legacy samba4[6-8] ports the
968 upgrade procedure is a bit convoluted.
970 You are safe to perform fresh new install of samba410 port. In case you
971 are upgrading from the previous versions of Samba, please use the
974 0. Take backups of all the relevant files, in particular PREFIX/etc/smb4.conf
975 and /var/db/samba4/ subdirectory. Keep in mind that files there (may)
976 have extended attributes, so use appropriate tools to preserve them.
978 1a. If you haven't updated Samba between 20190619 and 20190630 then next
979 step should be as simple as:
981 portmaster -o net/samba410 net/samba48
983 1b. If you have been affected by the archiving legacy versions of
984 Samba-related libraries for legacy versions of Samba, which happened
985 in the given time frame, then you need to reverse operation from the
988 for users of portmaster:
989 portmaster -o devel/talloc devel/talloc1
990 portmaster -o devel/tevent devel/tevent1
991 portmaster -o databases/tdb databases/tdb1
992 portmaster -o net/samba410 net/samba48
994 for users of portupgrade:
995 portupgrade -o devel/talloc devel/talloc1
996 portupgrade -o devel/tevent devel/tevent1
997 portupgrade -o databases/tdb databases/tdb1
998 portupgrade -o net/samba410 net/samba48
1001 AFFECTS: users of samba4[6-8] and devel/talloc, devel/tevent, databases/tdb, databases/ldb*
1002 AUTHOR: timur@FreeBSD.org
1004 To introduce samba410(we deliberately skip samba49 due the complexity of handling)
1005 and to drop dependency on deprecated Python 2.7, Samba supplementary libraries
1006 talloc, tevent and tdb were split into current Python 3 compatible versions
1007 and legacy ones, with the suffix "1".
1009 Old versions of Samba were changed to depend on the legacy supplementary libraries,
1010 so if you need to install samba46, samba47 or samba48 over previous Samba
1011 installations you need to downgrade supplementary libs with the following commands:
1013 for users of portmaster:
1014 portmaster -o devel/talloc1 devel/talloc
1015 portmaster -o devel/tevent1 devel/tevent
1016 portmaster -o databases/tdb1 databases/tdb
1017 portmaster -r talloc1
1019 for users of portupgrade:
1020 portupgrade -o devel/talloc1 devel/talloc
1021 portupgrade -o devel/tevent1 devel/tevent
1022 portupgrade -o databases/tdb1 databases/tdb
1023 portupgrade -fr devel/talloc1
1026 AFFECTS: users of www/qt5-webengine
1027 AUTHOR: kai@FreeBSD.org
1029 Users that upgrade www/qt5-webengine without using pkg/poudriere might
1030 experience failures due to conflicts with the installed version of 5.12.2.
1032 In that case, pkg delete -f the qt5-webengine package before building
1033 the updated version.
1036 AFFECTS: users of net/routinator
1037 AUTHOR: rodrigo@FreeBSD.org
1039 Release 0.4.0 fundamentally changes the command line options for
1040 running the server and introduces a new way to initialize the local RPKI
1041 repository used by Routinator.
1042 If you have been using previous releases, you will likely have to adjust
1043 your tooling. We apologize for this, but we also feel that the new commands
1044 are more intuitive and logical.
1047 AFFECTS: users of net/samba47
1048 AUTHOR: antoine@FreeBSD.org
1050 The default version of samba has been switched from 4.7 to 4.8.
1051 Upgrade instructions:
1053 For package users having samba47 installed indirectly (as a dependency):
1056 For package users having samba47 installed directly (leaf port):
1058 # pkg install samba48
1061 If you want to keep samba47, add DEFAULT_VERSIONS+= samba=4.7 to make.conf
1063 If you want to upgrade to samba48, remove samba47:
1064 # pkg delete -f samba47
1067 # portmaster net/samba48
1071 # portinstall net/samba48