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