Tweak graphics/pgplot version 5.2.2_27
[dports.git] / UPDATING
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
3 they are unavoidable.
4
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.
7
8 20200811:
9   AFFECTS: users of *-emacs26-* packages
10   AUTHOR: jrm@FreeBSD.org
11
12   With the release of Emacs version 27.1, the major version of editors/emacs has
13   changed from 26 to 27.  This means the names of some dependent packages have
14   also changed, so simply running `pkg upgrade` will not upgrade foo-emacs26-x
15   to foo-emacs27-x.  To update these packages, run these commands with superuser
16   privileges.
17
18   Binary package users:
19
20     # sh
21     # for i in $(pkg query -g %n '*-emacs26*'); do \
22         nn=$(echo "$i" | sed -e 's/emacs26/emacs27/'); \
23         pkg set -yn "$i":"$nn"; \
24       done;
25     # pkg upgrade
26
27   portmaster users:
28
29     # portmaster -r emacs
30
31 20200803:
32   AFFECTS: users of lang/perl5*
33   AUTHOR: mat@FreeBSD.org
34
35   The default Perl version has been switched to Perl 5.32.  If you are using
36   binary packages to upgrade your system, you do not have anything to do, pkg
37   upgrade will do the right thing.  For the other people, follow the
38   instructions in entry 20161103, it should still be the same.
39
40 20200726:
41   AFFECTS: users of net-mgmt/librenms
42   AUTHOR:  dvl@FreeBSD.org
43
44   The %%WWWDIR%%%/logs directory has been relocated to /var/log/librenms/
45   via the APP_LOG directive in %%WWWDIR%%%/.env.example - this won't affect
46   existing installs, but you are strongly encouraged to update your .env file
47   settings and relocate your logs.
48
49   Logs which were going to /var/log/messages and /var/log/librenms/ now only go
50   to /var/log/librenms/
51
52 20200720:
53   AFFECTS: users of net-mgmt/librenms
54   AUTHOR:  dvl@FreeBSD.org
55
56   As mentioned previously in 20200503 polling via cronjob has been removed as of
57   release 1.63 - see
58   https://community.librenms.org/t/dropping-support-for-php-7-1-and-python-2/11851
59
60   A database upgrade is required:
61
62      cd /usr/local/www/librenms
63      sudo ./lnms migrate
64
65   You must  migrate to the Dispatch Service:
66   https://docs.librenms.org/Extensions/Dispatcher-Service/
67
68   You may need to add LIBRENMS_USER to .env (see .env.example).
69
70   These steps should get you running:
71   * comment out the crontab entries listed above under PYPOLLER
72   * populate %%WWWDIR%%/.env with:
73     * APP_KEY - see farther below for how to create
74     * NODE_ID - see just below for how to create
75     * DB_HOST
76     * DB_DATABASE
77     * DB_USERNAME
78     * DB_PASSWORD
79   * you can create a NODE_ID with: php -r 'echo uniqid() . "\n";'
80   * sysrc librenms_enable="YES"
81   * service librenms start
82
83 20200719:
84   AFFECTS: users of emulators/qemu
85   AUTHOR: bofh@FreeBSD.org
86
87   emulators/qemu has been updated to 4.2.1. Previous 4.1.X branch has
88   been repocopied to emulators/qemu41. If someone wants to stick with 4.1.X
89   branch please use one of the following command:
90
91   # pkg install emulators/qemu41
92     or
93   # portmaster -o emulators/qemu41 emulators/qemu
94     or
95   # portupgrade -o emulators/qemu41 emulators/qemu
96
97 20200716:
98   AFFECTS: users of shells/bash, shells/bash-static
99   AUTHOR: ehaupt@FreeBSD.org
100
101   In order to cleanly decouple bash from base, bash now reads `profile` from
102   LOCALBASE/etc insead of from /etc. If you are using system wide bash
103   configuration in /etc/profile please migrate to LOCALBASE/etc/profile
104
105   # cp /etc/profile /usr/local/etc/profile
106
107   or create a symlink
108
109   # ln -s /etc/profile /usr/local/etc/
110
111   If you encounter the following error, you may have the obsolete
112   /lib/libreadline.so.8 lying around after an incomplete base update:
113
114   ld-elf.so.1: Undefined symbol "rl_signal_event_hook" referenced from COPY relocation in /usr/local/bin/bash
115
116   Please refer to to (23.5.6.2) in the FreeBSD Handbook on how to
117   safely check for outdated files and libraries:
118
119   https://www.freebsd.org/doc/en/books/handbook/makeworld.html
120
121 20200713:
122   AFFECTS: users of mail/php7[2-4]-imap
123   AUTHOR: tz@FreeBSD.org
124
125   The imap module of PHP was compiled against cclient till now. But this lib is
126   unmaintained for over 7 years. When combined with modern OpenSSL there are
127   various crashes reported.
128
129   Switching to the fork panda-cclient fixes these issues. Therefore we make the
130   usage of Panda cclient the new default. If you want to use the old cclient,
131   you need to enable it now!
132   
133 20200616:
134   AFFECTS: users of www/baikal
135   AUTHOR: gahr@FreeBSD.org
136
137   The www/baikal has been upated to 0.7.1. With the 0.7.0 release, our
138   configuration format was updated to use YAML files. You need to go through
139   the installer again but we pre-fill most values with the ones from your old
140   installation. We recommend that you make a full backup of your data, as a
141   safety measure. Starting with 0.7.0, Baikal stores data in both the Specific
142   and the config folders. Keep this in mind when upgrading!
143
144   Known issue:: Upgrading from versions older than 0.6.1 does not work.
145
146 20200613:
147   AFFECTS: users of editors/libreoffice
148   AUTHOR: fluffy@FreeBSD.org
149
150   LibreOffice was updated to 6.4 branch with some critical changes:
151   - GTK2 option is obsolete by upstream
152   - GTK3 option is not more set by default because of unstable yet and have visual glitches
153   - QT5 option is set by default to provide comfy visual style for every user
154   - KDE option was renamed to KF5 follows upstream
155
156   Please re-run "make config" to pick up the new defaults
157
158 20200610:
159   AFFECTS: users of www/node
160   AUTHOR: bhughes@FreeBSD.org
161
162   The www/node port has been updated to Node.js v14.0.0, the latest
163   upstream release. This is a major release, including many significant
164   changes. Users are encouraged to read the release announcements before
165   upgrading:
166
167   https://nodejs.org/en/blog/release/v14.0.0/
168
169 20200602:
170   AFFECTS: users of www/radicale
171   AUTHOR: decke@FreeBSD.org
172
173   Migration from radicale 1.x to 2.x requires that you export the storage
174   with radicale 1.1.6 before updating.
175
176   Migration instructions are available at:
177   https://web.archive.org/web/20190314225402/https://radicale.org/1to2/
178
179 20200602:
180   AFFECTS: users of sysutils/py-salt
181   AUTHOR: krion@FreeBSD.org
182
183   This port is moved to sysutils/py-salt-2019 and sysutils/py-salt was
184   updated to version 3000.
185
186   If you wish to use pysalt-2019 in the future, you might run the
187   following command:
188
189   # pkg set -o sysutils/py-salt:sysutils/py-salt-2019
190   # pkg upgrade
191
192 20200531:
193   AFFECTS: users of mail/postfix-policyd-spf-python
194   AUTHOR:  yasu@utahime.org
195
196   This port is now deprecated because upstream project is superseded by its
197   successor. So uninstall this port and install mail/py-spf-engine instead.
198   Keep in mind that the path of configuration file is changed from
199   ${PREFIX}/etc/postfix-policyd-spf-python/policyd-spf.conf to
200   ${PREFIX}/etc/python-policyd-spf/policyd-spf.conf. So you need to move
201   it to new location unless you use the default one without changing.
202
203 20200526:
204   AFFECTS: users of databases/mariadb104-client, databases/mariadb104-server
205   AUTHOR: brnrd@FreeBSD.org
206
207   The ports now add sample configuration files to /usr/local/etc/mysql. You
208   must merge your client configation with the conf.d/client.cnf and your
209   server configuration with conf.d/server.cnf.
210
211 20200518:
212   AFFECTS: users of converters/libiconv
213   AUTHOR: zeising@FreeBSD.org
214
215   Support for the Japanese specific patches have been discontinued.
216   These were previously added in a nondefault ports options, for people who
217   needed them.
218   If you still need them, it might be possible to create a port of libiconv 1.14
219   which includes those patches.
220
221 20200517:
222   AFFECTS: users of x11/sddm
223   AUTHOR: arrowd@FreeBSD.org
224
225   The home directory of sddm user has been moved to /var/lib/sddm. It is advised
226   to run following commands as root after updating the package:
227
228     # pw usermod -n sddm -d /var/lib/sddm
229     # pwd_mkdb /etc/master.passwd
230     # mv /usr/local/etc/sddm/home/state.conf /var/lib/sddm/state.conf
231     # rm -rf /usr/local/etc/sddm/home
232
233   Otherwise, SDDM will keep using /usr/local/etc/sddm/home/ as its HOME.
234
235 20200515:
236   AFFECTS: users of devel/libphutil, devel/arcanist-lib, devel/phabricator
237   AUTHOR: grembo@FreeBSD.org
238
239   Upstream fully deprecated devel/libphutil and merged its functionality
240   into devel/arcanist-lib and devel/phabricator. As a result, the
241   devel/libphutil port will be removed from the ports tree.
242
243   After upgrading devel/(arcanist-lib|phabricator) to version 20200514, it is
244   recommended to remove the orphaned libphutil package by running:
245
246     # pkg delete php\*-libphutil
247
248   Alternatively, 'pkg autoremove' will also work as expected, but might
249   remove orphaned packages unrelated to this update.
250
251 20200505:
252   AFFECTS: users of net-im/pidgin-rocketchat
253   AUTHOR: tobias.rehbein@web.de
254
255   This port has been turned into a libpurple plugin (net-im/purple-rocketchat)
256   to support other libpurple clients than pidgin.
257
258   This also changes some dependencies and you should run the following command
259   to prevent pidgin from being autoremoved.
260
261   # mark pidgin as being not automatically installed
262   pkg set -A 0 pidgin
263
264 20200504:
265   AFFECTS: users of x11-wm/hs-xmonad
266   AUTHOR:  arrowd@FreeBSD.org
267
268   From now, it is recommended to use "build script" method to compile XMonad
269   config. See https://github.com/xmonad/xmonad-testing/ for general info and
270   port's pkg-message for concrete steps.
271
272 20200503:
273   AFFECTS: users of net-mgmt/librenms
274   AUTHOR:  dvl@FreeBSD.org
275
276   Polling via cronjob is deprecated as of release 1.63
277   Please see https://community.librenms.org/t/dropping-support-for-php-7-1-and-python-2/11851
278
279   Please migrate to the Dispatch Service:
280   https://docs.librenms.org/Extensions/Dispatcher-Service/
281
282   These steps should get you running:
283   * comment out the crontab entries listed above under PYPOLLER
284   * populate %%WWWDIR%%/.env with:
285     * APP_KEY - see farther below for how to create
286     * NODE_ID - see just below for how to create
287     * DB_HOST
288     * DB_DATABASE
289     * DB_USERNAME
290     * DB_PASSWORD
291   * you can create a NODE_ID with: php -r 'echo uniqid() . "\n";'
292   * sysrc librenms_enable="YES"
293   * service librenms start
294
295 20200501:
296   AFFECTS: users of www/phpmyfaq
297   AUTHOR: flo@FreeBSD.org
298
299   phpMyFAQ has been updated to 3.0.2, old templates are not compatible with
300   this new version. Please see:
301
302   https://www.phpmyfaq.de/docs/3.0#3.4
303
304 20200428:
305   AFFECTS: users of sysutils/ansible
306   AUTHOR: bofh@FreeBSD.org
307
308   Ansible has been updated to 2.9.7. Please follow the porting guide
309   to update the rulesets:
310
311   https://docs.ansible.com/ansible/devel/porting_guides/porting_guide_2.9.html
312
313   If you wish to stay with 2.8 version, you can switch
314   to new sysutils/ansible28 port, which tracks stable 2.8 branch:
315
316   # pkg set -n ansible:ansible28
317
318 20200428:
319   AFFECTS: x11-servers/xwayland-devel
320   AUTHOR: jbeich@FreeBSD.org
321
322   DRI3 is enabled by default since mesa-libs-18.3.2_4, so you no
323   longer need to define LIBGL_DRI3_ENABLE in ~/.profile or ~/.login.
324
325   See 20200308 entry for more details.
326
327 20200422:
328   AFFECTS: users of devel/kyua
329   AUTHOR: brooks@FreeBSD.org
330
331   A tests group has been added and the tests user should be a member
332   of it by default rather than nobody. You should update your password
333   database to match (change the group from 65534 to 977 after updating).
334
335   Please use the following command to do so:
336
337   pw usermod -n tests -g tests
338
339 20200408:
340   AFFECTS: users of security/openssh-portable
341   AUTHOR: bdrewery@FreeBSD.org
342
343   OpenSSH was upgraded to 8.2p1 on 2020-03-23.
344
345   A restart of sshd is required after upgrade due to an incompatibility
346   introduced in 8.2.
347
348   Please see https://www.openssh.com/txt/release-8.2 for upcoming
349   deprecation notices.
350
351 20200408
352   AFFECTS: users of net/irrd
353   AUTHOR: bofh@FreeBSD.org
354
355   Legacy version of net/irrd has been moved to net/irrd-legacy.
356   net/irrd has been upgraded to 4.X branch. If someone wants to stick with
357   legacy version then pkg users have to do something like
358
359   # pkg set -o net/irrd:net/irrd-legacy
360
361   For portmaster users
362   # portmaster -o net/irrd-legacy net/irrd
363
364   Both of the version can be installed and used concurrently in case there is
365   a need for migration
366
367 20200403:
368   AFFECTS: users of x11-fonts/fontconfig
369   AUTHOR: desktop@FreeBSD.org
370
371   Fontconfig 2.13.1 generated .uuid files in the fonts directory which where
372   not properly registered to the packages. To clean them up, please execute the
373   following command:
374
375         find /usr/local/share/fonts -type f -name .uuid -delete
376
377 20200326:
378   AFFECTS: users of devel/sonarqube and devel/sonar-ant-task
379   AUTHOR: netchild@FreeBSD.org
380
381   The outdated port devel/sonarqube has moved to
382   devel/sonarqube-community to make it clear that it is the community
383   edition. The log and DB files are still stored in the same location.
384
385   The devel/sonar-ant-task port has moved to devel/sonarqube-ant-task
386   to match the upstream-name. The install location is renamed
387   accordingly.
388
389   At the same time the user/group of the sonarqube port changed from
390   www:www to sonarqube:sonarqube.
391
392   It is expected that nobody was using the 6.2 version from 2016
393   anymore and no change needs to be done. No analysis was done to check
394   if the old 6.2 version can be updated in-place to the 8.2 version.
395   As such if there is still someone using the old 6.2 version, you may
396   have to delete /var/log/sonarqube and /var/db/sonarqube before
397   installing the new version.
398
399 20200320
400   AFFECTS: users of devel/qca
401   AUTHOR: kde@FreeBSD.org
402
403   New versions of devel/qca stopped supporting OpenSSL < 1.1.
404   For this reason devel/qca-legacy has been added, which is
405   held back at an older version until FreeBSD 11 goes EOL.
406
407   Ports depending on devel/qca should stop adding direct LIB_DEPENDS
408   and switch to depending on it via USES=qca.
409
410   FreeBSD 11 users might want to run something like
411
412       pkg set -o devel/qca:devel/qca-legacy
413
414 20200320:
415   AFFECTS: users of x11/libxkbcommon
416   AUTHOR: zeising@FreeBSD.org
417
418   The libxkbcommon library (x11/libxkbcommon), used to handle keyboards
419   in some applications, most notably kde and wayland, have been switched
420   to use evdev rules by default on FreeBSD 12 and later.  Some keys, most
421   notably arrow keys, may not work in applications using libxkbcommon if
422   you are using xf86-input-keyboard rather than xf86-input-libinput.
423   If you have trouble with the keyboard keys, and if /var/log/Xorg.*.log
424   shows that the "kbd" or "keyboard" driver is being used, you need to
425   switch to legacy rules by setting the environment variable
426   XKB_DEFAULT_RULES to xorg.
427   This switch is made to match the default configuration on FreeBSD 12.1 and
428   later, the default configuration on FreeBSD 11.3 still uses the legacy
429   rules.
430
431 20200316:
432   AFFECTS: users of net-im/slack-term
433   AUTHOR: dmgk@FreeBSD.org
434
435   The config file location was changed from ~/.slack-term to
436   ~/.config/slack-term/config, please move your existing config file
437   accordingly.
438
439 20200308
440   AFFECTS: users of graphics/mesa-libs and legacy graphics drivers
441   AUTHOR: zeising@FreeBSD.org
442
443   The mesa OpenGL library (graphics/mesa-libs) has been switched to use DRI3
444   by default, instead of the older DRI2 interface.  This might cause regressions
445   when using the legacy graphics drivers, either through
446   graphics/drm-legacy-kmod or the graphics drivers in base.
447
448   If you experience issues when running OpenGL applications it is possible
449   to force the use of DRI2 by setting the LIBGL_DRI3_DISABLE environment
450   variable to 1 before starting any OpenGL application.  The easiest way to
451   do this is by adding it to either your shell startup files or .xinitrc.
452
453 20200306
454   AFFECTS: users of databases/mysql80-server
455   AUTHOR: joneum@FreeBSD.org
456
457   As of MySQL 8.0.16, the MySQL server performs the upgrade tasks previously
458   handled by mysql_upgrade. Consequently, mysql_upgrade is unneeded and is
459   deprecated as of that version, and will be removed in a future MySQL version.
460   Because mysql_upgrade no longer performs upgrade tasks,
461   it exits with status 0 unconditionally.
462
463 20200303:
464   AFFECTS: users of net-mgmt/librenms
465   AUTHOR: dvl@FreeBSD.org
466
467   1. Apache / mod_php options removed
468
469   The APACHEMOD option has been removed. LibreNMS can be used
470   with other webservers, not just Apache. In order to simplify
471   the port, the option was removed.
472
473   Now you manually install the webserver of your preference.
474
475   If upgrading from LibreNMS < 1.61, you can do this to
476   prevent 'pkg autoremove' from uninstalling Apache / mod_php:
477
478   $ sudo pkg set -A 0 apache24 mod_php74
479   Mark apache24-2.4.41 as not automatically installed? [y/N]: y
480   Mark mod_php74-7.4.3 as not automatically installed? [y/N]: y
481
482   Adjust mod_php74 to suit the version of mod_php you have.
483
484   2. include/defaults.inc.php is gone
485
486   The file include/defaults.inc.php is no longer distributed by
487   the upstream project. The FreeBSD port patched this file to
488   correct the paths to common tools such as ping, snmpwalk, etc.
489
490   These values previously adjusted by the port must now be specified
491   in config.php. New installs will have this automatically, but existing
492   installs must be updated manually. These are the entries you should
493   add if upgrading from LibreNMS < 1.61:
494
495   $config['snmpwalk']       = '/usr/local/bin/snmpwalk';
496   $config['snmpget']        = '/usr/local/bin/snmpget';
497   $config['snmpbulkwalk']   = '/usr/local/bin/snmpbulkwalk';
498   $config['snmptranslate']  = '/usr/local/bin/snmptranslate';
499
500   $config['ping']           = '/sbin/ping';
501   $config['mtr']            = '/usr/local/bin/mtr';
502   $config['nmap']           = '/usr/local/bin/nmap';
503
504   $config['nagios_plugins'] = '/usr/local/libexec/nagios';
505   $config['ipmitool']       = '/usr/local/bin/ipmitool';
506   $config['virsh']          = '/usr/local/bin/virsh';
507   $config['dot']            = '/usr/local/bin/dot';
508   $config['sfdp']           = '/usr/local/bin/sfdp';
509   $config['nfdump']         = '/usr/local/bin/nfdump';
510
511 20200229:
512   AFFECTS: users of textproc/apache-solr
513   AUTHOR: mfechner@FreeBSD.org
514
515   Apache-solr switched to the supported java LTS version 11.
516   Make sure you update the following files accordingly:
517   /usr/local/etc/solr.in.sh (see /usr/local/etc/solr.in.sh.sample)
518   /usr/local/etc/javavm_opts.conf (JAVA_HOME=/usr/local/openjdk11/)
519
520 20200225:
521   AFFECTS: users of net-mgmt/netbox
522   AUTHOR: kai@FreeBSD.org
523
524   1. Removal of the Topology Maps feature
525
526   The deprecated topology maps feature has been removed.  Please replicate
527   any required data to another source before upgrading NetBox to v2.7.7, as
528   any existing topology maps will be deleted.
529
530
531   2. Changed REDIS database configuration settings
532
533   The REDIS database configuration parameters were splitted up in two
534   discrete subsections named "webhooks" and "caching" with the 2.7 release.
535   This requires modification of the REDIS parameter in configuration.py as
536   follows:
537
538   Old Redis sample configuration:
539
540   REDIS = {
541     'HOST': 'localhost',
542     'PORT': 6379,
543     'PASSWORD': '',
544     'DATABASE': 0,
545     'CACHE_DATABASE': 1,
546     'DEFAULT_TIMEOUT': 300,
547     'SSL': False,
548   }
549
550   New Redis sample configuration:
551
552   REDIS = {
553     'webhooks': {
554         'HOST': 'redis.example.com',
555         'PORT': 1234,
556         'PASSWORD': 'foobar',
557         'DATABASE': 0,
558         'DEFAULT_TIMEOUT': 300,
559         'SSL': False,
560     },
561     'caching': {
562         'HOST': 'localhost',
563         'PORT': 6379,
564         'PASSWORD': '',
565         'DATABASE': 1,
566         'DEFAULT_TIMEOUT': 300,
567         'SSL': False,
568     }
569   }
570
571   Note that the CACHE_DATABASE parameter has been removed and the connection
572   settings have been duplicated for both webhooks and caching.  This allows
573   one to make use of separate Redis instances if desired.  It is fine to use
574   the same Redis service for both functions, although the database
575   identifiers should be different.
576
577   Please also check the pkg-message and the changelogs for further info.
578
579 20200223:
580   AFFECTS: users of security/gsasl
581   AUTHOR: hrs@FreeBSD.org
582
583   The library part of security/gsasl has been split into security/libgsasl.
584   The security/gsasl now depends on security/libgsasl. Due to this change,
585   old security/gsasl conflicts with the new security/libgsasl and it can
586   prevent the installed security/gsasl from upgrading. Please remove the
587   installed security/gsasl before upgrading if a conflict error occurs.
588
589 20200220:
590   AFFECTS: users of x11-servers/xorg-server
591   AUTHOR: zeising@FreeBSD.org
592
593   x11-servers/xorg-server has been updated to 1.20.7.
594
595   With this update, xorg-server has switched from using the devd backend to
596   the udev backend for device configuration on FreeBSD 12 and 13.  If you have
597   issues with input devices, please see the install message for details.
598
599   The HAL backend option has been completely removed, as it was deprecated.
600
601   If you have problems with input devices, ensure that both x11/libinput and
602   x11-drivers/xf86-input-libinput are installed.  They are installed in the
603   default configuration, but if you have a custom configuration, they might not
604   be.
605
606 20200210:
607   AFFECTS: users of net-im/prosody
608   AUTHOR: thomas@beingboiled.info
609
610   Prosody's pid file and data directory have moved to a new location.
611   If you are upgrading from a version with the pid file and data
612   directory in /usr/local/var/lib/prosody please perform these steps:
613
614     # stop Prosody
615     pkill -F /usr/local/var/lib/prosody/prosody.pid
616
617     # copy the data directory
618     cp -a /usr/local/var/lib/prosody /var/db/prosody
619     rm -f /var/db/prosody/prosody.pid
620
621   Make sure your prosody config has the following option set:
622
623     pidfile = "/var/run/prosody/prosody.pid"
624
625   Then start Prosody again. Everything should be working as before and
626   the /usr/local/var/lib/prosody directory can now be removed.
627
628 20200207:
629   AFFECTS: users of security/nss
630   AUTHOR: lwhsu@FreeBSD.org
631
632   NSS header files and libraries have been moved from ${PREFIX}/include/nss/nss
633   and ${PREFIX}/lib/nss to ${PREFIX}/include/nss and ${PREFIX}/lib
634
635 20200204:
636   AFFECTS: users of editors/vim
637   AUTHOR: adamw@FreeBSD.org
638
639   The PYTHON2 and PYTHON3 options have been turned into a single PYTHON
640   option that uses whichever python you've set as default. However,
641   this means that you cannot have both python2 and python3 support at
642   the same time.
643
644 20200126:
645   AFFECTS: users of multimedia/gstreamer1-plugins[-bad]
646   AUTHOR: kwm@freebsd.org
647
648   In GStreamer 1.16 some files moved from the gstreamer1-plugins-bad package
649   to the gstreamer1-plugins package.
650
651   If your using a tool like portmaster or portupgrade delete the old -bad
652   port and then follow the normal upgrade method.
653   # pkg delete -f gstreamer1-plugins-bad
654
655 20200126:
656   AFFECTS: users of sysutils/helm
657   AUTHOR: danilo@FreeBSD.org
658
659   The Helm project have deprecated the Tiller utility in Helm 3. If you are using
660   Helm 2 you will need to migrate the configuration to be compatible with Helm 3.
661   Please, refer to the following documentation for more information about the
662   migration process:
663
664   https://helm.sh/blog/migrate-from-helm-v2-to-helm-v3/
665
666   Note that the 2to3 plugin binary is not available for FreeBSD and you will need
667   to compile it yourself.
668
669 20200113:
670   AFFECTS: users of python and net/samba410, devel/talloc, devel/tevent, databases/tdb, databases/ldb*
671   AUTHOR: timur@FreeBSD.org
672
673   In the entry 20191216 for the Python update the filtering constrains
674   are too limiting and omit the Samba supplimentary libraries, which do
675   have Python bindings to the default Python 3.x version. With the update
676   of the default Python3 version you also need to rebuild all the
677   supplimentary Samba libraries and samba410 itself.
678
679   For portmaster users it would be enough to run:
680
681   # portmaster devel/talloc devel/tevent databases/tdb databases/ldb15 net/samba410
682
683
684 20200109:
685   AFFECTS: www/firefox
686   AUTHOR: gecko@FreeBSD.org
687
688   Firefox requires Capsicum since r522464 for IPC and in future will
689   require Capsicum for process sandboxing. If you use a custom kernel
690   make sure to copy the following lines from GENERIC kernel:
691
692     options     CAPABILITY_MODE         # Capsicum capability mode
693     options     CAPABILITIES            # Capsicum capabilities
694
695 20200107:
696   AFFECTS: Users of *-emacs27-* packages
697   AUTHOR: ashish@FreeBSD.org
698
699   There is a major version bump in 28.0.50, therefore to upgrade all the
700   packages dependent on editors/emacs-devel, please use the following commands:
701
702     # sh
703     # for i in $(pkg query -g %n '*-emacs27*'); do \
704         nn=$(echo "$i" | sed -e 's/emacs27/emacs28/'); \
705         pkg set -yn "$i":"$nn"; done;
706     # pkg upgrade
707
708 20200106:
709   AFFECTS: users of net/gnatsd
710   AUTHOR: olgeni@FreeBSD.org
711
712   net/gnatsd has been replaced by net/nats-server to reflect the
713   new naming upstream.
714
715   All options in rc.conf should be renamed by replacing 'gnats'
716   with 'nats' (nats_enable, nats_user, nats_options).
717
718 20200101:
719   AFFECTS: users of security/openssl and security/openssl111
720   AUTHOR: brnrd@FreeBSD.org
721
722   The openssl port was removed on 2019-12-31, subsequently the openssl111
723   port was renamed to openssl on 2020-01-01.
724
725   The shared library version of OpenSSL has been bumped.
726
727   Users of DEFAULT_VERSIONS= ssl=openssl111 must update this to
728   ssl=openssl.
729
730   You must rebuild all ports that depend on OpenSSL if you use OpenSSL
731   from ports.
732
733 20191226:
734   AFFECTS: users of sysutils/dsbmd
735   AUTHOR: mk@freeshell.de
736
737   With version 1.10 dsbmd now uses sysutils/fusefs-jmtpfs for mounting
738   MTP devices. Please adjust your dsbmd.conf or recreate it from the new
739   dsbmd.conf.sample.
740
741 20191225:
742   AFFECTS: multimedia/libva-intel-media-driver
743   AUTHOR: jbeich@FreeBSD.org
744
745   As of libva 2.6.0 iHD driver is automatically enabled, so you no
746   longer need to adjust LIBVA_DRIVER_NAME in ~/.profile or ~/.login.
747
748 20191221:
749   AFFECTS: users of misc/openhab2
750   AUTHOR: netchild@FreeBSD.org
751
752   If you upgrade from a pevious version, make a backup of
753         /var/db/openhab2
754   read about the breaking changes in the release notes at
755         https://github.com/openhab/openhab-distro/releases/tag/2.5.0
756   and run
757         %%PREFIX%%/libexec/openhab2/runtime/bin/update.freebsd
758   which takes care about changes for:
759         - Textual Configuration
760         - Next Generation Rule Engine
761
762 20191216:
763   AFFECTS: users of python
764   AUTHOR: antoine@FreeBSD.org
765
766   Default version of python3 and python was switched to 3.7.
767
768   For ports users wanting to keep version 3.6 as default,
769   add DEFAULT_VERSIONS+= python=3.6 python3=3.6 to make.conf
770
771   This may ease the upgrade for users of pre-build packages:
772   # sh
773   # for i in $(pkg query -g %n 'py36-*'); do pkg set -yn ${i}:py37-${i#py36-}; done
774   # pkg upgrade
775
776   For portmaster users:
777   # sh
778   # portmaster -o lang/python37 python36
779   # REINSTALL="$(pkg info -o py36-\* | awk '{printf "%s ", $2}')"
780   # pkg delete -f py36-\*
781   # portmaster $REINSTALL
782   # REBUILD=$(pkg query -g "%n:%dn" '*' | grep py3 | grep -v py37 | cut -d : -f 1 | sort -u)
783   # portmaster $REBUILD
784   # REBUILD2=$(pkg list | grep python-36 | xargs pkg which | awk '{print $6}' | sort -u)
785   # portmaster $REBUILD2
786
787 20191204
788   AFFECTS: users of mail/nextcloud-mail
789   AUTHOR: brnrd@FreeBSD.org
790
791   Version 0.20.0 removed the default mail configuration via config.php.
792   All users will be prompted to enter account and SMTP- and IMAP-server
793   details for sending and reading email.
794
795 20191126:
796   AFFECTS: consumers of net/py-urllib3
797   AUTHOR: kai@FreeBSD.org
798
799   Since version 1.25 HTTPS connections are now verified by default which is
800   done via "cert_reqs = 'CERT_REQUIRED'".  While certificate verification
801   can be disabled via "cert_reqs = 'CERT_NONE'", it's highly recommended to
802   leave it on.
803
804   Various consumers of net/py-urllib3 already have implemented routines that
805   either explicitly enable or disable HTTPS certificate verification (e.g.
806   via configuration settings, CLI arguments, etc.).
807
808   Yet it may happen that there are still some consumers which don't
809   explicitly enable/disable certificate verification for HTTPS connections
810   which could then lead to errors (as is often the case with self-signed
811   certificates).
812
813   In case of an error one should try first to temporarily disable
814   certificate verification of the problematic urllib3 consumer to see if
815   this approach will remedy the issue.
816
817 20191125:
818   AFFECTS: users of emulators/qemu
819   AUTHOR: bofh@FreeBSD.org
820
821   emulators/qemu31 has been updated to 4.1.1. Previous 3.1.X branch has
822   been repocopied to emulators/qemu31. If someone wants to stick with 3.1.X
823   branch please use one of the following command:
824
825   # pkg install emulators/qemu31
826     or
827   # portmaster -o emulators/qemu31 emulators/qemu
828     or
829   # portupgrade -o emulators/qemu31 emulators/qemu
830
831 20191124:
832   AFFECTS: users of irc/eggdrop
833   AUTHOR: dbaio@FreeBSD.org
834
835   The irc/eggdrop port has been updated to 1.8.4 and its config is not
836   backward compatible with 1.6.21. A new port was created to keep 1.6.21
837   version available at irc/eggdrop16 and it will be available for 3 months
838   until users have time to upgrade their configuration.
839
840   More information at:
841   https://raw.githubusercontent.com/eggheads/eggdrop/v1.8.4/NEWS
842
843   If you would like to keep using 1.6.21, please run the following command
844   to update pkg database:
845
846     pkg set -n eggdrop:eggdrop16
847     pkg set -o irc/eggdrop:irc/eggdrop16
848
849 20191108:
850   AFFECTS: users of databases/redis[-devel]
851   AUTHOR: osa@FreeBSD.org
852
853   The databases/redis port has been updated to the recent stable release.
854   Users wanting to stay on v4.x can replace databases/redis with
855   databases/redis4 with one of the following commands:
856
857   # pkg install databases/redis4
858     or
859   # portmaster -o databases/redis4 databases/redis
860     or
861   # portupgrade -o databases/redis4 databases/redis
862
863 20191103:
864   AFFECTS: users of www/node
865   AUTHOR: bhughes@FreeBSD.org
866
867   The www/node port has been updated to Node.js v13.0.0, the latest
868   upstream release. A new port, www/node12, has been created for the
869   v12.x LTS branch. Users wanting to stay on v12.x can replace www/node
870   with www/node12 with one of the following commands:
871
872   # pkg install www/node12
873     or
874   # portmaster -o www/node12 www/node
875     or
876   # portupgrade -o www/node12 www/node
877
878 20191029:
879   AFFECTS: users of emulators/open-vm-tools[-nox11]
880   AUTHOR: jpaetzel@FreeBSD.org
881
882 open-vm-tools 11.0.1 has removed the vmxnet driver.  This driver has been
883 in tree for quite some time and hopefully everyone is using the in tree
884 version, however if you had removed device vmx from your kernel, or are
885 running an unsupported version of FreeBSD which didn't have the driver
886 included in the base system, updating your open-vm-tools version will
887 leave you without networking.
888
889 20191026:
890   AFFECTS: users of www/qt5-webengine
891   AUTHOR: kai@FreeBSD.org
892
893   Users that upgrade www/qt5-webengine without using pkg/poudriere might
894   experience failures due to conflicts with the installed version of 5.12.2.
895
896   In that case, pkg delete -f the qt5-webengine package before building
897   the updated version.
898
899 20191025:
900   AFFECTS: users of x11/nvidia-driver (and slave ports)
901   AUTHOR: danfe@FreeBSD.org
902
903   x11/nvidia-driver* ports no longer install Linux programs and libraries,
904   which had been moved to their own ports (x11/linux-nvidia-libs*).  When
905   updating the driver package next time, remember to install them manually
906   if you need to run Linux OpenGL programs.
907
908 20191016:
909   AFFECTS: users of KDE Plasma Desktop (x11/plasma5*)
910   AUTHOR: kde@FreeBSD.org
911
912   With Plasma 5.17 the startup script has been renamed. People who use the
913   .xinitrc method to start Plasma have to call the new binary.
914
915   Previously:
916         exec ck-launch-session startkde
917   Change to:
918         exec ck-launch-session startplasma-x11
919
920 20191014:
921   AFFECTS: users of mail/rspamd, mail/rspamd-devel
922   AUTHOR: vsevolod@FreeBSD.org
923
924   Sample configuration files has been removed as default configuration files
925   are NOT intended for modification by users and SHOULD be overwritten on
926   port upgrade.
927
928   Make sure the default configuration files are unmodified and migrate all
929   configuration changes to the proper places, before you continue.
930
931 20191002:
932   AFFECTS: users of textproc/groff
933   AUTHOR: bapt@FreeBSD.org
934
935   with groff 1.2.4_3, groff does not depend anymore on ghostscript and
936   netpbm. In order to be able to properly use the html backend the user
937   can install ghostscript and netpbm from ports without the need of
938   reinstalling the package.
939
940   Also note that the X11 option has been removed.
941
942 20190930:
943   AFFECTS: users of net-mgmt/netbox
944   AUTHOR: kai@FreeBSD.org
945
946   Since the 2.6 release a running Redis server instance is required for
947   caching objects to run.  Also the following settings like below need to be
948   added (or modified) in the existing configuration.py:
949
950   REDIS = {
951     'HOST': 'localhost',
952     'PORT': 6397,
953     'PASSWORD': ''
954     'DATABASE': 0,
955     'CACHE_DATABASE': 1,
956     'DEFAULT_TIMEOUT': 300,
957     'SSL': False,
958   }
959
960   Note that if you were using these settings in a prior release with
961   webhooks, the DATABASE setting remains the same but an additional
962   CACHE_DATABASE settings has been added with a default value of 1 to
963   support the caching backend.
964
965   The DATABASE setting will be renamed in a future release of NetBox to
966   better relay the meaning of the setting.  It is highly recommended to keep
967   the webhook and cache databases separate.  Using the same database number
968   for both may result in webhook processing data being lost during cache
969   flushing events.
970
971   Please also check the pkg-message and the changelogs for further info.
972
973 20190927:
974   AFFECTS: users of emulators/qemu-devel
975   AUTHOR: bofh@FreeBSD.org
976
977   qemu-devel has been updated to 4.1.0 and 4.0.0 has been merged into a new port
978   emulators/qemu40. If you want to stick with 4.0.X branch, simply use:
979   # portmaster -o emulators/qemu-devel emulators/qemu40
980
981 20190927:
982   AFFECTS: users of XFCE desktop (x11-wm/xfce4)
983   AUTHOR: madpilot@FreeBSD.org
984
985   Due to changes in the XFCE 4.14 metaport, systems could end up with
986   both xscreensaver and xfce4-screensaver installed and enabled
987   simultaneously.
988
989   This can cause conflicts and problems unlocking the screen.
990
991   To avoid problems, please make sure to have only one enabled by
992   going to the Application Autostart tab of the Session and Startup
993   settings applet and enable only one Screensaver there.
994
995   Some further information can be found in the xfce4-session
996   pkg-message displayed on installation and upgrade.
997
998 20190920:
999   AFFECTS: users of net-mgmt/pushgateway
1000   AUTHOR: 0mp@FreeBSD.org
1001
1002   The persistent storage format used by pushgateway in the latest version
1003   is not backwards compatible. See the pushgateway changelogs for details.
1004
1005 20190911:
1006   AFFECTS: users of security/bastillion
1007   AUTHOR: netchild@FreeBSD.org
1008
1009   The datastore of bastillion needs to be updated:
1010     java -jar $PREFIX/jetty_bastillion/upgrade/bastillion-upgrade-3.08.00.jar \
1011       $PREFIX/jetty_bastillion/bastillion/WEB-INF/classes/BastillionConfig.properties
1012
1013 20190909:
1014   AFFECTS: users of lang/ruby25
1015   AUTHOR: mfechner@FreeBSD.org
1016
1017   The default ruby version has been updated from 2.5 to 2.6.
1018
1019   If you compile your own ports you may keep 2.5 as the default version by
1020   adding the following lines to your /etc/make.conf file:
1021
1022   #
1023   # Keep ruby 2.5 as default version
1024   #
1025   DEFAULT_VERSIONS+=ruby=2.5
1026
1027   If you wish to update to the new default version, you need to first stop any
1028   software that uses ruby. Then, you will need to follow these steps, depending
1029   upon how you manage your system.
1030
1031   If you use pkgng, simply upgrade:
1032   # pkg upgrade
1033
1034   If you do not use pkg, please check entry 20190420.
1035   The description there should also work for this version.
1036
1037 20190906:
1038   AFFECTS: users of devel/py-fabric
1039   AUTHOR: dbaio@FreeBSD.org
1040
1041   Fabric (devel/py-fabric) was upgraded to 2.5.0, Fabric (2+) represents
1042   a near-total reimplementation and reorganization of the software.
1043
1044   Fabric 2 is not at 100% feature parity with 1.x! Some features have been
1045   explicitly dropped, but others simply have not been ported over yet,
1046   either due to time constraints or because said features need to be
1047   re-examined in a modern context.
1048
1049   More information at:
1050   https://www.fabfile.org/upgrading.html#upgrading
1051   https://www.fabfile.org/upgrading.html#upgrade-specifics
1052
1053   If you would like to keep using 1.x, please run the following command to
1054   update pkg database:
1055
1056     pkg set -n py27-fabric:py27-fabric1
1057     pkg set -o devel/py-fabric:devel/py-fabric1
1058