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 20220929:
   9   AFFECTS: users of graphics/bmeps
  10   AUTHOR: takefu@airport.fm
  11
  12   The executable name has been changed from this edition from bmpp to bitmap2pp
  13
  14 20220925:
  15   AFFECTS: users of security/libressl
  16   AUTHOR: brnrd@FreeBSD.org
  17
  18   The port has been updated to the latest stable version 3.5 of LibreSSL.
  19   The shared library versions of the libraries have been bumped.
  20
  21   After upgrading, manually update all packages that depend on any of the
  22   libraries provided by LibreSSL (libssl, libcrypto and libtls) since the
  23   versions of these libraries have changed. Normally, you can obtain the
  24   list of dependent software by running the following command:
  25
  26   # pkg info -r libressl
  27
  28   Then you should rebuild all ports depending on libressl to avoid dangling
  29   shared library dependencies.
  30
  31 20220919:
  32   AFFECTS: users of sysutils/schilyutils
  33   AUTHOR: fuz@fuz.su
  34
  35   Schilyutils has been split up into two ports. If you want the bosh shell,
  36   the new port is shells/bosh, which can be installed with:
  37
  38   # pkg install bosh
  39     or
  40   # portmaster -o shells/bosh
  41
  42 20220918:
  43   AFFECTS: users of mail/roundcube
  44   AUTHOR: brnrd@FreeBSD.org
  45
  46   Roundcube has been upgraded to 1.6.0 and introduces breaking changes to
  47   configuration options of remote services (imap, smtp, ldap, sieve). Check
  48   https://roundcube.net/news/2022/07/28/roundcube-1.6.0-released for details.
  49
  50   Version 1.6 no longer includes the Classic and Larry skins, which are now
  51   available as separate mail/roundcube-classic and mail/roundcube-larry ports.
  52
  53 20220910:
  54   AFFECTS: users of devel/cmake
  55   AUTHOR: diizzy@FreeBSD.org
  56
  57   CMake has been converted to a meta-port and new CMake packages created causes
  58   conflicts with old binary packages prior to this change.
  59
  60   If CMake was installed using binary packages via pkg it needs to be
  61   uninstalled using pkg delete before installing CMake and related packages
  62   after this change.
  63
  64     pkg delete cmake
  65     pkg install cmake-core
  66
  67   If you're using portmaster you also need to delete the old CMake package
  68   before upgrading.
  69
  70 20220909:
  71   AFFECTS: users of emulators/qemu
  72   AUTHOR: bofh@FreeBSD.org
  73
  74   emulators/qemu has been updated to 7.1.0. Previous 7.0.X branch has
  75   been repocopied to emulators/qemu70. If someone wants to stick with 7.0.X
  76   branch please use one of the following command:
  77
  78   # pkg install qemu70/qemu70-nox11(based on flavor used)
  79     or
  80   # portmaster -o emulators/qemu70 emulators/qemu
  81     or
  82   # portupgrade -o emulators/qemu70 emulators/qemu
  83
  84 20220903:
  85   AFFECTS: users of editors/vim
  86   AUTHOR: adamw@FreeBSD.org
  87
  88   The Vim port no longer installs a system-wide vimrc. It drastically affected
  89   config loading order, and led to various settings being clobbered, duplicated,
  90   or ignored.
  91
  92   Vim's provided defaults.vim (/usr/local/share/vim/vim90/defaults.vim) continues
  93   to be read just as before, but its settings are no longer clobbered. Take a look
  94   in there for any settings you may want to change, and do ':h initialization' to
  95   see where Vim looks for config files.
  96
  97 20220903:
  98   AFFECTS: users of archivers/py-borgbackup
  99   AUTHOR: mandree@FreeBSD.org
 100
 101   Borgbackup has been upgraded to version 1.2.  For users who you wish to
 102   continue using version 1.1, use either of these commands for upgrading:
 103
 104   With binary packages through pkg:
 105     pkg set -o archivers/py-borgbackup:archivers/py-borgbackup11
 106     pkg upgrade
 107   With portmaster or portupgrade (replace the command accordingly):
 108     portmaster -o archivers/py-borgbackup11 archivers/py-borgbackup
 109
 110 20220901:
 111   AFFECTS: users of mail/rainloop-community
 112   AUTHOR: yasu@FreeBSD.org
 113
 114   Since 1.17.0 upstream distributes only one edition "lagacy" under MIT license
 115   and mail/rainloop-community is remove as a result. So please uninstall
 116   mail/rainloop-community (rainloop-community-phpXY) and install mail/rainloop
 117   (rainloop-phpXY) instead.
 118
 119 20220831:
 120   AFFECTS: users of x11/xscreensaver on 13.1-RELEASE
 121   AUTHOR: zirias@FreeBSD.org
 122
 123   With the update to 6.04, xscreensaver now uses security/unix-selfauth-helper
 124   for PAM authentication. This relies on pam_exec.so, which had a bug causing
 125   a segfault on authentication attempts prior to 13.1-RELEASE-p1. For details,
 126   please see
 127   https://www.freebsd.org/security/advisories/FreeBSD-EN-22:19.pam_exec.asc
 128
 129   Make sure your system is fully upgraded, otherwise you might be unable to
 130   unlock your screen.
 131
 132 20220825:
 133   AFFECTS: users of net/xrdp or net/xrdp-devel
 134   AUTHOR: meta@FreeBSD.org
 135
 136   After xorg upgrade to 21.1.4, xorgxrdp session doesn't start as before
 137   This is because bin/Xorg has been replaced with X server binary wrapper.
 138   You must manually edit the Xorg section in etc/xrdp/sesman.ini to get it
 139   working again.
 140
 141   The following is a short example of where, how to modify sesman.ini.
 142   Make sure to replace LOCALBASE with your actual path.
 143
 144    [Xorg]
 145    ; Specify the path of non-suid Xorg executable. It might differ depending
 146    ; on your distribution and version. Find out the appropreate path for your
 147    ; environment. The typical path is known as follows:
 148    ;
 149    ; Fedora 26 or later    :  param=/usr/libexec/Xorg
 150    ; Debian 9 or later     :  param=/usr/lib/xorg/Xorg
 151    ; Ubuntu 16.04 or later :  param=/usr/lib/xorg/Xorg
 152    ; Arch Linux            :  param=/usr/lib/Xorg
 153    ; CentOS 7              :  param=/usr/bin/Xorg or param=Xorg
 154    ; CentOS 8              :  param=/usr/libexec/Xorg
 155    ;
 156   -param=Xorg
 157   +param=LOCALBASE/libexec/Xorg
 158
 159 20220815:
 160   AFFECTS: users of net/keycloak
 161   AUTHOR: fernape@FreeBSD.org
 162
 163   The flavors -mysql and -postgres were removed, the necessary configuration
 164   for those database backends was rolled into the base release by upstream.
 165   The configuration files changed completely, so they need to be rebuilt from
 166   scratch.
 167
 168 20220807:
 169   AFFECTS: users of news/inn
 170   AUTHOR: kbowling@FreeBSD.org
 171
 172   The inn port has been updated to 2.7 release.  Users upgrading from
 173   prior versions should read through the announcement for any manual
 174   upgrading steps that apply to your environment.
 175
 176   https://lists.isc.org/pipermail/inn-announce/2022-July/000015.html
 177
 178 20220711:
 179   AFFECTS: users of security/stunnel
 180   AUTHOR: zi@FreeBSD.org
 181
 182   The stunnel port has been updated to drop privileges to the stunnel
 183   user by default.
 184
 185   As a result of this change, the pid file location has changed.  If
 186   you have a running copy of stunnel, you should stop the process
 187   before performing the upgrade.  Alternatively, you will need to
 188   # pkill stunnel;service stunnel start
 189   after the upgrade has been completed.
 190
 191 202207XYZ:
 192   AFFECTS: users of devel/maven-wrapper and devel/maven
 193   AUTHOR: michaelo@apache.org
 194
 195   The environment variable M2_HOME has been replaced with more common
 196   MAVEN_HOME which can be used to pass a custom Maven home directory.
 197
 198 20220629:
 199   AFFECTS: updating x11-servers/xorg-server from a port
 200   AUTHOR: se@FreeBSD.org
 201
 202   The xorg-server port now has a library dependency on x11/libxcvt,
 203   which cannot be installed when the previous version of xorg-server
 204   is present.  To be able to update xorg-server from a port, the
 205   previous version needs to be manually deinstalled to allow libxcvt
 206   to be installed.
 207
 208 20220628:
 209   AFFECTS: users of Erlang and Elixir
 210   AUTHOR: dch@FreeBSD.org
 211
 212   For more than a decade, the Elixir Mix tool and the Erlang rebar
 213   or erlang.mk build tools have been the defacto way of installing
 214   and managing packages for specific applications.
 215
 216   All main-stream applications, from Riak, CouchDB, RabbitMQ, Phoenix,
 217   and Elixir, expect that packages are fetched and compiled into an OTP
 218   Release, with in-built version locking, external package management.
 219
 220   There is no point in maintaining a large number of libraries, that
 221   are used neither for development, nor operations.
 222
 223   Users are directed to https://rebar3.org/ https://erlang.mk/ or
 224   https://elixir-lang.org/getting-started/mix-otp/introduction-to-mix.html
 225   to fetch custom packages.
 226
 227   https://www.freebsd.org/status/report-2021-07-2021-09/#_freebsd_erlang_ecosystem_ports_update
 228
 229 20220626:
 230   AFFECTS: users of python
 231   AUTHOR: thierry@FreeBSD.org
 232
 233   The default version of python3 and python was switched to 3.9.
 234
 235   For ports users wanting to keep version 3.8 as default,
 236   add DEFAULT_VERSIONS+= python=3.8 python3=3.8 to make.conf
 237
 238   Following procedures may ease the upgrade:
 239
 240   For users of pre-build packages:
 241   # sh
 242   # for i in $(pkg query -g %n 'py38-*'); do pkg set -yn ${i}:py39-${i#py38-}; done
 243   # pkg upgrade
 244
 245   For portmaster users:
 246   # sh
 247   # portmaster -o lang/python39 python38
 248   # REINSTALL="$(pkg info -o "*py38*" | awk '{printf "%s ", $2}')"
 249   # pkg delete -f "*py38*"
 250   # portmaster $REINSTALL
 251   # REBUILD=$(pkg query -g "%n:%dn" '*' | grep py3 | grep -v py39 | cut -d : -f 1 | sort -u)
 252   # portmaster $REBUILD
 253   # REBUILD2=$(pkg list | grep python-38 | xargs pkg which | awk '{print $6}' | sort -u)
 254   # portmaster $REBUILD2
 255
 256   Final steps (for pre-built packages & portmaster):
 257
 258   If no longer required, Python 3.8 can be removed via
 259   "pkg remove python38" and the directory /usr/local/lib/python3.8 can
 260   then be deleted afterwards, if not empty.
 261
 262 20220625:
 263   AFFECTS: users of sysutils/fusefs-bindfs
 264   AUTHOR: doralitze@chaotikum.org
 265
 266   Bindfs defaults to use direct I/O since version 1.16. While this results
 267   in major performance improvements as well as several bug fixes, this also
 268   breaks direct legacy calls to mmap. If your application still uses them
 269   consider these two options:
 270
 271   1. Mount using `--no-direct-io`
 272   2. Upgrade your application in order to query mapping guards
 273
 274 20220623:
 275   AFFECTS: users of science/gramps
 276   AUTHOR: fernape@FreeBSD.org
 277
 278   databases/py-bsddb3 is deprecated and will be removed in the future. With that
 279   gramps will lose the ability to load family trees using Berkeley DB.
 280   It is suggested to migrate all family trees using Berkeley DB by exporting
 281   them to gramps xml and import that gramps xml into a family tree using sqlite
 282   as database.
 283
 284 20220620:
 285   AFFECTS: users of www/selenium
 286   AUTHOR: fernape@FreeBSD.org
 287
 288   The port has changed startup args so if you are using selenium_args= in
 289   rc.conf you need to add the parameter "standalone" manually.
 290
 291 20220616:
 292   AFFECTS: users of net-mgmt/netbox
 293   AUTHOR: kai@FreeBSD.org
 294
 295   /!\ WARNING /!\
 296
 297   The NetBox 3.2 release contains major changes, so at least items 1.), 2.)
 298   and 3.) must be checked before proceeding with the upgrade!
 299
 300   /!\ WARNING /!\
 301
 302   1. This release includes a database migration that will remove the "asn",
 303      "contact_name", "contact_phone", and "contact_email" fields from the
 304      site model.  (These fields have been superseded by the ASN and contact
 305      models introduced in NetBox v3.1.)
 306
 307      To protect against the accidental destruction of data, the upgrade
 308      process will fail if any sites still have data in any of these fields.
 309
 310      To bypass this safeguard, set the NETBOX_DELETE_LEGACY_DATA environment
 311      variable when running the upgrade script, which will permit the
 312      destruction of legacy data.
 313
 314      A set of migration scripts is available to assist with the migration of
 315      legacy site data:
 316
 317      https://github.com/netbox-community/migration-scripts
 318
 319   2. NetBox v3.2 requires Python 3.8 or later.
 320
 321   3. If the NetBox Plugin "net-mgmt/py-netbox-plugin-extension" is used,
 322      please disable it before the migrations are applied.  This can be done
 323      by removing the entry "netbox_plugin_extensions" from the "PLUGINS"
 324      section in the NetBox configuration.
 325
 326      Once the upgrade is done, this port/package can be safely removed as
 327      it's no longer required.
 328
 329   4. Please also check the pkg-message and the changelogs for further info.
 330
 331 20220608:
 332   AFFECTS: devel/autoconf-wrapper, devel/autoconf213
 333   AUTHOR: tijl@FreeBSD.org
 334
 335   These ports have been renamed to devel/autoconf-switch and devel/autoconf2.13
 336   respectively.  If your favourite port updating tool cannot handle that then
 337   just remove the packages with "pkg delete" and then install the new port.
 338
 339 20220607:
 340   AFFECTS: security/openssh-portable
 341   AUTHOR: bdrewery@FreeBSD.org
 342
 343   OpenSSH has been updated to 9.0p1 with incompatible changes.
 344   See https://www.openssh.com/txt/release-9.0 for details.
 345
 346 20220602:
 347   AFFECTS: sysutils/graylog
 348   AUTHOR: dch@FreeBSD.org
 349
 350   Graylog 4.3.0+ fails to start if graylog's internal collector for
 351   system statistics is enabled. This will eventually be addressed
 352   upstream.
 353
 354   Add disable_native_system_stats_collector=true to your graylog.conf.
 355
 356 20220513:
 357   AFFECTS: devel/nexus2-oss
 358   AUTHOR: michael.osipov@siemens.com
 359
 360   Nexus 2.15.x introduces incompatible configuration changes. You
 361   must review changes in ETCDIR/wrapper.conf and ETCDIR/jetty*.xml
 362   with updated samples as well as NEXUS_WORKDIR/conf/logback-nexus.xml
 363   with its origin from
 364   DATADIR/nexus/WEB-INF/lib/nexus-core-VERSION.jar!/META-INF/log/logback-nexus.xml,
 365   grant write access to files in ETCDIR since Nexus itself might
 366   update files in place otherwise your instance will not properly
 367   work after the update.
 368
 369 20220510
 370   AFFECTS: sysutils/zrepl
 371   AUTHOR: monwarez@gmail.com
 372
 373   The zrepl update to 0.5.0.8 includes the following breaking changes:
 374   - The Prometheus metric zrepl_version_daemon was converted to zrepl_start_time
 375   The metric still reports the zrepl version in a label.
 376   But the metric *value* is now the Unix timestamp at the time the daemon was started.
 377   The Grafana dashboard in zrepl examples directory has been updated.
 378
 379 20220502:
 380   AFFECTS: mail/mutt
 381   AUTHOR: dereks@lifeofadishwasher.com
 382
 383   Default header cache option has been changed to the new option LMDB using
 384   databases/lmdb. The BDB option still exists but now uses databases/db18 due
 385   to the EOL of databases/db5.
 386
 387 20220501:
 388   AFFECTS: users of drm-current-kmod and drm-devel-kmod
 389   AUTHOR: manu@FreeBSD.org
 390
 391   Both ports where removed.
 392   If you were using either one of them directly (i.e. without using
 393   graphics/drm-kmod metaport) use graphics/drm-510-kmod.
 394   If you have some problems with this one try drm-54-kmod and report
 395   a bug on https://github.com/freebsd/drm-kmod.
 396
 397 20220428:
 398   AFFECTS: users of databases/redis
 399   AUTHOR: yasu@FreeBSD.org
 400
 401   The databases/redis port has been updated to 7.0. Users wanting to
 402   stay on 6.2 can replace databases/redis with databases/redis62 with
 403   one of the following commands.
 404
 405   If you use pkg with binary packages:
 406     # pkg set -o databases/redis:databases/redis62
 407     # pkg upgrade
 408   If you use portmaster:
 409     # portmaster -o databases/redis62 databases/redis
 410   If you use portupgrade:
 411     # portupgrade -o databases/redis62 databases/redis
 412
 413 20220426:
 414   AFFECTS: users of deskutils/grantleetheme
 415   AUTHOR: kde@FreeBSD.org
 416
 417   The pkg update of deskutils/grantleetheme to 22.04 can fail due
 418   to a filesystem location having changed from being a file to being
 419   a directory. This leads to pkg's temporary file creation throwing
 420   an error.
 421
 422   To update to KDE Gear 22.04 please run
 423   # pkg delete -f grantleetheme
 424   prior to the update.
 425
 426 20220424:
 427   AFFECTS: users of emulators/qemu
 428   AUTHOR: bofh@FreeBSD.org
 429
 430   emulators/qemu has been updated to 7.0.0. Previous 6.2.X branch has
 431   been repocopied to emulators/qemu6. If someone wants to stick with 6.2.X
 432   branch please use one of the following command:
 433
 434   # pkg install qemu6/qemu6-nox11(based on flavor used)
 435     or
 436   # portmaster -o emulators/qemu6 emulators/qemu
 437     or
 438   # portupgrade -o emulators/qemu6 emulators/qemu
 439
 440 20220421:
 441   AFFECTS: users of lang/ruby27
 442   AUTHOR: yasu@FreeBSD.org
 443
 444   The default ruby version has been updated from 2.7 to 3.0.
 445
 446   If you compile your own ports you may keep 2.7 as the default version by
 447   adding the following lines to your /etc/make.conf file:
 448
 449   #
 450   # Keep ruby 2.7 as default version
 451   #
 452   DEFAULT_VERSIONS+=ruby=2.7
 453
 454   If you wish to update to the new default version, you need to first stop any
 455   software that uses ruby. Then, you will need to follow these steps, depending
 456   upon how you manage your system.
 457
 458   If you use pkg, simply upgrade:
 459   # pkg upgrade
 460
 461   If you do not use pkg, please check entry 20190420.
 462   The description there should also work for this version.
 463
 464 20220413:
 465   AFFECTS: users of net-im/py-matrix-synapse
 466   AUTHOR: ports@skyforge.at
 467
 468   Synapse will now refuse to start up if open registration is enabled,
 469   in order to help mitigate abuse across the federation. If you would
 470   like to provide registration to anyone, consider adding email,
 471   recaptcha or token-based verification in order to prevent automated
 472   registration from bad actors. This check can be disabled by setting
 473   the enable_registration_without_verification option in your
 474   homeserver configuration file to true. More details are available in
 475   the upgrade notes[0].
 476
 477   Synapse will additionally now refuse to start when using PostgreSQL
 478   with a non-C values for COLLATE and CTYPE, unless the config flag
 479   allow_unsafe_locale, found in the database section of the
 480   configuration file, is set to true. See the upgrade notes[1] for
 481   details.
 482
 483   [0] https://matrix-org.github.io/synapse/v1.56/upgrade.html#open-registration-without-verification-is-now-disabled-by-default
 484   [1] https://matrix-org.github.io/synapse/v1.56/upgrade#change-in-behaviour-for-postgresql-databases-with-unsafe-locale
 485
 486 20220410:
 487   AFFECTS: users of sysutils/screen
 488   AUTHOR: cy@FreeBSD.org
 489
 490   As of sysutils/screen-4.9.0_5, the MULTUSER option is default, reverting
 491   to the traditional setuid-root behavior. People who wish to secure their
 492   screen install must terminate all screen sessions, then install screen
 493   without the MULTIUSER option. The option was reversed because it caused
 494   too much astonishment among users of screen.
 495
 496 20220401:
 497   AFFECTS: security/sshguard
 498   AUTHOR: kevinz5000@gmail.com
 499
 500   Blacklisting is now disabled by default to avoid overriding the setting in
 501   sshguard.conf. To enable blacklisting, uncomment the BLACKLIST_FILE line in
 502   sshguard.conf.
 503
 504 20220329:
 505   AFFECTS: users of sysutils/screen
 506   AUTHOR: cy@FreeBSD.org
 507
 508   As of sysutils/screen-4.9.0_3, the multiuser feature is not supported
 509   by default. The multiuser feature requires setuid root to function.
 510   This creates a security risk. Some Linux distributions have had
 511   non-setuuid root screen for a dozen or more years. FreeBSD is following
 512   suit. A new MULTIUSER option has been added to enable users to install
 513   setuid root screen. The MULTIUSER option default is OFF.
 514
 515   Users who wish to use the multiuser feature may,
 516
 517   - Build screen using the MULTIUSER option, or
 518   - Poudriere users can use poudriere-options to enable the MULTIUSER
 519     option, or
 520   - Users can chmod the setuid bit for ${LOCALBASE}/bin/screen-4.9.0,
 521     making screen setuid root to enable the multiuser feature.
 522
 523 20220326:
 524   AFFECTS: users of misc/freebsd-doc-*
 525   AUTHOR: blackend@FreeBSD.org
 526
 527   A change to the doc toolchain prevents the build of individual
 528   localized HTML versions of the documentation without building the
 529   en_US version.  HTML option is currently disabled until a good
 530   solution is found.  PDF version, the default option, is now the only
 531   available option.
 532
 533   Please re-run "make config" to pick up this new default.
 534
 535 20220313:
 536   AFFECTS: users of net/unison
 537   AUTHOR: madpilot@FreeBSD.org
 538
 539   unison has been updated to version 2.52. The new version introduces
 540   a new wire protocol and on disk archive format. This new version
 541   is compatible with 2.51 clients for communication, so it's now
 542   possible to upgrade one side and then the other.
 543
 544   The archive files are automatically converted to the new version,
 545   but once they are converted the y are incompatible with the
 546   previous version.
 547
 548   In case you need version 2.51, the previous version of the port
 549   is preserved in net/unison251.
 550
 551 20220311:
 552   AFFECTS: users of multimedia/get_iplayer
 553   AUTHOR: jamie@catflap.org
 554
 555   get_iplayer has a number of changes to quality settings that may
 556   break existing configurations. Please see the release notes for
 557   further information:
 558
 559   https://github.com/get-iplayer/get_iplayer/wiki/release320to329#release329
 560
 561 20220311:
 562   AFFECTS: users of emulators/virtualbox-ose
 563   AUTHOR: grembo@FreeBSD.org
 564
 565   In order to comply to hier(7), VirtualBox's configuration of non-default
 566   IP ranges to be used in host-only mode moved from /etc/vbox/networks.conf
 567   to ${LOCALBASE}/etc/vbox/networks.conf.
 568
 569 20220311:
 570   AFFECTS: users of net/nats-server
 571   AUTHOR: olgeni@FreeBSD.org
 572
 573   A dedicated 'nats' user was added, replacing 'nobody' in the startup script.
 574   You should check your configuration and assign updated ownership to your data
 575   files.
 576
 577 20220227:
 578   AFFECTS: users of graphics/bmeps
 579   AUTHOR: takefu@airport.fm
 580
 581   The binary and man page have been renamed from bmpp{.1.gz} to bitmap2pp{.1.gz}
 582
 583 20220225:
 584   AFFECTS: users of x11-toolkits/py-wxPython40
 585   AUTHOR: lbartoletti@FreeBSD.org
 586
 587   x11-toolkits/py-wxPython40 has been removed to be replaced by the 4.1
 588   version.
 589   However the new wxPython ports is now named x11-toolkits/py-wxPython4.
 590
 591   Depending on the tools you use, you may have to remove the port
 592   before ports upgrade.
 593
 594 20220224:
 595   AFFECTS: users of net-im/openfire
 596   AUTHOR: nikita@druba.su
 597
 598   The port version have been updated from 4.6.x to 4.7.x.
 599   It is recommended to do database and configs backup before updating.
 600
 601 20220219:
 602   AFFECTS: users of sysutils/intel-pcm-devel
 603   AUTHOR: egypcio@FreeBSD.org
 604
 605   sysutils/intel-pcm-devel became quite obsolete once sysutils/intel-pcm is
 606   now pretty much following a constant and stable update cycle, so users of
 607   the -devel version are encouraged to switch to it.
 608
 609   If you still have sysutils/intel-pcm-devel installed, please delete it from
 610   your system and install sysutils/intel-pcm instead:
 611
 612   # pkg delete sysutils/intel-pcm-devel
 613   # pkg install sysutils/intel-pcm
 614
 615 20220219:
 616   AFFECTS: users of math/qhull*
 617   AUTHOR: stephen@FreeBSD.org
 618
 619   Because of entries in MOVED, portupgrade can get confused updating qhull.
 620   It is recommended that you delete qhull and ports depending upon it, and
 621   then reinstalling all the dependent ports.
 622
 623 20220218:
 624   AFFECTS: users of TeX*
 625   AUTHOR: bofh@FreeBSD.org
 626
 627   TeX system has been updated to 2021 from 2015. Normal pkg upgrade or
 628   portmaster -a should handle all the upgrade properly. In case not please
 629   create a ticket or send a mail to tex@FreeBSD.org
 630
 631   print/tex-aleph has been removed as per upstream. This package should be
 632   removed manually. Additionally users have reported to delete
 633   texlive-texmf prior to starting update, or pkg-static will indicate
 634   there is a conflict during the upgrade of texlive-base :
 635
 636   # pkg remove tex-aleph texlive-texmf
 637
 638 20220218:
 639   AFFECTS: users of net-mgmt/librenms
 640   AUTHOR: dvl@FreeBSD.org
 641
 642   The storage directory has moved from WWWDIR to /var/db/librenms/storage
 643   to comply with man 7 hier. When upgrading, you may need to manually create
 644   this symlink.
 645
 646 20220212:
 647   AFFECTS: users of lang/php8[01][-extensions]?
 648   AUTHOR: bofh@FreeBSD.org
 649
 650   Non-Default OPTION MYSQL80 has been removed in lieu of making
 651   php8[01]-openssl as part of DEFAULT php8[01] installation. Although
 652   for php74 it is not the case. Ports that depends on
 653   security/php8[01]-openssl will no longer be installed as these have
 654   been removed. There is no side effect of this for ports which have
 655   USE_PHP=openssl. In case for php74 as the default php74-openssl will
 656   be installed otherwise it will be used from php installation.
 657
 658   If you are using pkg, you have to remove php8[01]-openssl manually after
 659   the upgrade :
 660
 661   # pkg info \*php8\* > ~/installed-php-ports-list
 662
 663   # pkg upgrade -y
 664   # pkg delete -f php8[01]-openssl
 665   # service -R
 666
 667   While rebuilding from ports users old php.conf is not overwritten. So
 668   have to manually remove the ports. For portmaster users:
 669   # sh
 670   # REINSTALL="$(pkg info -o "*php80*" | grep -v openssl | awk '{printf "%s ", $2}')"
 671   # pkg delete -f "*php80*"
 672   # portmaster $REINSTALL
 673   # portmaster -a
 674
 675 20220207:
 676   AFFECTS: users of security/amavisd-new
 677   AUTHOR: flo@FreeBSD.org
 678
 679   Amavis does now depend on archivers/7-zip (7zz) you might need to update
 680   your amavisd.conf and replace all ocurances of p7zip (7zr) accordingly.
 681
 682 20220129:
 683   AFFECTS: users of editors/neovim
 684   AUTHOR: adamw@FreeBSD.org
 685
 686   Neovim now uses luajit-openresty as the Lua provider. Many neovim plugins
 687   compile some of their code (Packer does this, as do many LSP plugins).
 688   Neovim will produce errors and fail to load the plugins.
 689
 690   Deleting and reinstalling any plugins that produce errors should fix the
 691   startup.
 692
 693   If you use Packer, you also want to delete the startup cache:
 694
 695   # rm -rf ~/.config/nvim/plugin/packer_compiled.lua
 696
 697 20220128:
 698   AFFECTS: users of x11-fonts/source-sans-ttf
 699   AUTHOR: fernape@FreeBSD.org
 700
 701   The font name has changed its prefix from SourceSansPro* to SourceSans*.
 702   Users of this font might need to change their configurations to pick up
 703   the new names.
 704
 705 20220128:
 706   AFFECTS: users of net-im/dendrite
 707   AUTHOR: ashish@FreeBSD.org
 708
 709   The configuration needs to be updated to version 2 following upgrade to
 710   Dendrite v0.6. Please refer to /usr/local/etc/dendrite/dendrite.yaml.sample
 711   for a sample configuration.
 712
 713 20220127:
 714   AFFECTS: users of PyQt
 715   AUTHOR: kde@FreeBSD.org
 716
 717   Most of the PyQt ports have been merged into single port devel/py-qt5-pyqt.
 718   `pkg upgrade` will handle update automatically .
 719
 720 20220126:
 721   AFFECTS: users of mail/bogofilter, mail/bogofilter-lmdb
 722   AUTHOR: mandree@FreeBSD.org
 723
 724   The default version of mail/bogofilter now uses LMDB instead
 725   of Berkeley DB. It is not compatible and cannot read databases.
 726
 727   Your options are:
 728   1. use bogoutil on each wordlist for each of your users first,
 729   ONLY THEN reinstall bogofilter, THEN reload the databases with bogoutil,
 730   OR
 731   2. install the matching bogofilter version and
 732   If you had been using bogofilter-lmdb so far, install bogofilter.
 733   If you had been using bogofilter so far, install bogofilter-bdb.
 734
 735 20220125:
 736   AFFECTS: users of lang/php74
 737   AUTHOR: tz@FreeBSD.org
 738
 739   The default version of PHP has been switched from 7.4 to 8.0.
 740
 741   If you use binary packages you should make a list of php packages
 742   before running 'pkg upgrade':
 743
 744   # pkg info \*php7\* > ~/installed-php-ports-list
 745
 746   After the upgrade, check with such list if all your php extensions
 747   are still installed, and reinstall them if needed.
 748
 749   If you use mod_php74 you need to deinstall it and install mod_php80.
 750
 751 20220120:
 752   AFFECTS: users of x11-wm/dwm
 753   AUTHOR: 0mp@FreeBSD.org
 754
 755   dwm has been updated to 6.3. The option RUGAPS is no longer available because
 756   it depends on a patch only available for version 6.2. RUGAPS can be
 757   reintroduced if desired once it is ported to 6.3 by the interested party.
 758
 759 20220118:
 760   AFFECTS: users of net-mgmt/netbox
 761   AUTHOR: kai@FreeBSD.org
 762
 763   1. Please make sure that the PostgreSQL server for the NetBox instance is
 764      running version 10 or higher.  This is because PostgreSQL 9.6 is
 765      End-of-Life since November 2021 and NetBox 3.1 makes use of the
 766      "macaddr8" field which was introduced with PostgreSQL 10.
 767
 768   2. Please also check the pkg-message and the changelogs for further info.
 769
 770 20220110:
 771   AFFECTS: users of security/bastillion
 772   AUTHOR: netchild@FreeBSD.org
 773
 774   If you already performed the actions of the next entry, the following
 775   action in this entry needs to be performed regardless.
 776   If you did not already perform the actions of the next entry, only
 777   the action of this entry needs to be performed.
 778
 779   The datastore of bastillion needs to be upgraded (if you do not see
 780   users / can not login, you forgot to upgrade it):
 781     java -jar %%PREFIX%%/jetty_bastillion/upgrade/bastillion-upgrade-4.00.01.jar %%PREFIX%%/jetty_bastillion/bastillion/WEB-INF/classes/BastillionConfig.properties
 782
 783 20220104:
 784   AFFECTS: users of security/bastillion
 785   AUTHOR: netchild@FreeBSD.org
 786
 787   The datastore of bastillion needs to be upgraded (if you do not see
 788   users / can not login, you forgot to upgrade it):
 789     java -jar %%PREFIX%%/jetty_bastillion/upgrade/bastillion-upgrade-4.00.00.jar %%PREFIX%%/jetty_bastillion/bastillion/WEB-INF/classes/BastillionConfig.properties
 790
 791 20220102:
 792   AFFECTS: users of sysutils/py-azure-cli
 793   AUTHOR: dbaio@FreeBSD.org
 794
 795   When upgrading to Azure CLI v2.31.0, you will need to re-authenticate on
 796   Azure services.
 797
 798     $ az login --use-device-code
 799
 800   Starting in version 2.30.0, Azure CLI uses MSAL as the underlying
 801   authentication library. MSAL uses AAD v2.0 authentication flow to provide more
 802   functionality and increases security for token cache.
 803   More info: https://docs.microsoft.com/en-us/cli/azure/msal-based-azure-cli
 804
 805 20211220:
 806   AFFECTS: users of devel/notcurses
 807   AUTHOR: nickblack@linux.com
 808
 809   Notcurses 3 introduces a new SONAME and significant API/ABI changes.
 810   Dependent applications must be recompiled at a minimum. A complete
 811   guide to updating for the new API is available under "Porting API2
 812   Applications to API3" at
 813   https://github.com/dankamongmen/notcurses/releases/tag/v3.0.0
 814
 815 20211220:
 816   AFFECTS: users of net-im/openfire
 817   AUTHOR: nikita@druba.su
 818
 819   The port options have been renamed to be more readable.
 820   When not using the default options, they have to be regenerated.
 821
 822   # cd /usr/ports/net-im/openfire
 823   # make config
 824
 825 20211213:
 826   AFFECTS: users of emulators/qemu-utils
 827   AUTHOR: bofh@FreeBSD.org
 828
 829   New port emulators/qemu@tools has been introduced which is similar to
 830   emulators/qemu-utils. qemu-utils has also been DEPRECATED in favor for
 831   this as it's MASTER port has also been marked DEPRECATED and set to
 832   expire on 2022-01-09. For updating to qemu-tools please use one of
 833   the following command:
 834
 835   # pkg install qemu-tools
 836     or
 837   # portmaster -o emulators/qemu-utils emulators/qemu@tools
 838
 839 20211116:
 840   AFFECTS: users of emulators/qemu50
 841   AUTHOR: bofh@FreeBSD.org
 842
 843   emulators/qemu50 has been moved to emulators/qemu5 and updated to 5.2.0
 844   which is the last version from 5.X.X branch. This is done in preparation
 845   of updating emulators/qemu into latest 6.X branch. If someone wants to
 846   stick with 5.X.X branch please use one of the following command:
 847
 848   # pkg install qemu5
 849     or
 850   # portmaster -o emulators/qemu50 emulators/qemu5
 851
 852   This version also introduces a stripped nox11 version which can be
 853   installed with:
 854   # pkg install qemu5-nox11
 855    or
 856   # portmaster emulators/qemu5@nox11
 857
 858 20211115:
 859   AFFECTS: AFFECTS: users of *-emacs2x-* packages
 860   AUTHOR: jrm@FreeBSD.org
 861
 862   To avoid problems when editors/emacs or editors/emacs-devel are
 863   updated, the emacs major version has been removed from these package
 864   names.
 865
 866   For example, the old and new package names of devel/magit are
 867
 868   -----------------------------------------------------------
 869   | Old Package Name          | New Package Name            |
 870   |-------------------------- |-----------------------------|
 871   | magit-emacs27             | magit                       |
 872   | magit-emacs27_nox         | magit-emacs_nox             |
 873   | magit-emacs27_canna       | magit-emacs_canna           |
 874   |                           |                             |
 875   | magit-emacs29_nox         | magit-emacs_devel_nox       |
 876   | magit-emacs29             | magit-emacs_devel           |
 877   -----------------------------------------------------------
 878
 879   To handle these final package name changes, follow a similar procedure
 880   as the one described in the 20200811 entry.  That is, simply running
 881   `pkg upgrade` will not upgrade, e.g., foo-emacs27_nox to
 882   foo-emacs_nox.
 883
 884   Binary package users:
 885
 886   To update these packages, run these commands under /bin/sh with superuser
 887   privileges before upgrading.
 888
 889   # default flavor of editors/emacs installed
 890   for i in $(pkg query -g %n '*-emacs27'); do
 891     if [ "$i" != "notmuch-emacs27" ]; then
 892       nn=$(echo "$i" | sed -e 's/-emacs27//')
 893     else
 894       nn=$(echo "$i" | sed -e 's/-emacs27/-emacs/')
 895     fi
 896     pkg set -yn "$i":"$nn"
 897   done
 898
 899   # canna or nox flavor of editors/emacs installed
 900   for i in $(pkg query -g %n '*-emacs27*'); do
 901     nn=$(echo "$i" | sed -e 's/emacs27/emacs/')
 902     pkg set -yn "$i":"$nn"
 903   done
 904
 905   # editors/emacs-devel installed
 906   for i in $(pkg query -g %n '*-emacs29*'); do
 907     nn=$(echo "$i" | sed -e 's/emacs29/emacs_devel/')
 908     pkg set -yn "$i":"$nn"
 909   done
 910
 911   portmaster users:
 912
 913   portmaster -r emacs
 914
 915 20211110:
 916   AFFECTS: users of www/node*, www/npm*, www/yarn*
 917   AUTHOR: mfechner@FreeBSD.org
 918
 919   The port framework was updated to use a default version for nodejs.
 920   The default version is pointing to the latest LTS version which is
 921   currently version 16.
 922   You can overwrite this by defining in /etc/make.conf, e.g. version 17:
 923   DEFAULT_VERSIONS=nodejs=17
 924
 925   Or if you would like to stick always to the current version use:
 926   DEFAULT_VERSIONS=nodejs=current
 927
 928   If you would like to use yarn or npm together with nodejs version 17,
 929   just install the package that is pulling the wanted dependency to nodejs:
 930
 931   # pkg install yarn-node17
 932   # pkg install npm-node17
 933
 934 20211109:
 935   AFFECTS: users of security/libressl
 936   AUTHOR: brnrd@FreeBSD.org
 937
 938   The port has been updated to the latest stable version 3.4 of LibreSSL.
 939   The shared library versions of the libraries have been bumped.
 940
 941   After upgrading, manually update all packages that depend on any of the
 942   libraries provided by LibreSSL (libssl, libcrypto and libtls) since the
 943   versions of these libraries have changed. Normally, you can obtain the
 944   list of dependent software by running the following command:
 945
 946   # pkg info -r libressl
 947
 948   Then you should rebuild all ports depending on libressl to avoid dangling
 949   shared library dependencies.
 950
 951 20211107:
 952   AFFECTS: users of sysutils/devcpu-data
 953   AUTHOR: jrm@FreeBSD.org
 954
 955   The RC variable name microcode_cpus is now deprecated.  Users should
 956   instead use the variable microcode_update_cpus.
 957
 958   Two new ports were branched from sysutils/devcpu-data,
 959   sysustils/devcpu-data-amd and sysustils/devcpu-data-intel.  The two
 960   new ports contain only the CPU microcode updates for each vendor and
 961   sysutils/devcpu-data now only contains an RC script.  Both new ports
 962   are on-by-default, optional dependencies of sysutils/devcpu-data.
 963
 964 20211101:
 965   AFFECTS: users of textproc/redisearch
 966   AUTHOR: osa@FreeBSD.org
 967
 968   The textproc/redisearch port has been updated to the recent stable
 969   release - v2.2.  Users wanting to stay on v2.0 can replace
 970   textproc/redisearch with textproc/redisearch20 with one of the
 971   following commands:
 972
 973   # pkg install textproc/redisearch20
 974     or
 975   # portmaster -o textproc/redisearch20 textproc/redisearch
 976     or
 977   # portupgrade -o textproc/redisearch20 textproc/redisearch
 978
 979   NOTE: The textproc/redisearch20 brings a new name for the module,
 980   i.e. redisearch20.so, so be careful.
 981
 982 20211024:
 983   AFFECTS: sysutils/beats7
 984   AUTHOR: otis@FreeBSD.org
 985
 986   The following breaking changes apply to beats 7.15.0 and newer:
 987
 988     - All beats:
 989     Loading Kibana assets (dashboards, index templates) rely on Saved Object API.
 990     So to provide a reliable service, Beats can only import and export dashboards
 991     using at least Kibana 7.15.
 992
 993     - Filebeat:
 994       - Remove all alias fields pointing to ECS fields from modules. This affects
 995         the Suricata and Traefik modules.
 996       - Fix Crowdstrike ingest pipeline that was creating flattened process fields.
 997       - Rename log.path to log.file.path in filestream to be consistent with log
 998         input and ECS.
 999
1000     - Heartbeat:
1001       - Remove long deprecated watch_poll functionality.
1002       - Fix inconsistency in event.dataset values between heartbeat and fleet by
1003         always setting this value to the monitor type / fleet dataset.
1004
1005     - Metricbeat:
1006       - Fix Elasticsearch jvm.gc.collectors.old being exposed as young
1007
1008   Full changelog:
1009     https://www.elastic.co/guide/en/beats/libbeat/current/release-notes-7.15.0.html
1010     https://www.elastic.co/guide/en/beats/libbeat/current/release-notes-7.15.1.html
1011
1012 20211024:
1013   AFFECTS: users of databases/postgresql* and other software using PostgreSQL to run
1014   AUTHOR: kbowling@FreeBSD.org
1015
1016   The default version of PostgreSQL has been switched from 12 to 13.
1017   The upgrade procedure can use up twice the space the databases
1018   currently needs. If you have a big amount of stored data take a
1019   closer look at the manpage of pg_upgrade for avoidance and/or
1020   speedup of the upgrade.
1021
1022   The upgrade instructions consider a basic usage and do not match
1023   complex scenarios like replication, sharding, or similar.
1024
1025   Upgrade instructions:
1026
1027   First stop your PostgreSQL, create PostgreSQL-binaries and backup your data.
1028   If you have another Version of PostgreSQL installed, for example 12.8, your
1029   files are named according to this.
1030
1031   # service postgresql stop
1032   # pkg create postgresql12-server postgresql12-contrib
1033   # mkdir /tmp/pg-upgrade
1034   # tar xf postgresql12-server-12.8.pkg -C /tmp/pg-upgrade
1035   # tar xf postgresql12-contrib-12.8.pkg -C /tmp/pg-upgrade
1036   # pkg delete -f databases/postgresql12-server databases/postgresql12-contrib databases/postgresql12-client
1037
1038   Now update PostgreSQL:
1039
1040     pkg user:
1041     # pkg install databases/postgresql13-server databases/postgresql13-contrib
1042     # pkg upgrade
1043
1044     Portmaster users:
1045     # portmaster databases/postgresql13-server databases/postgresql13-contrib
1046     # portmaster -a
1047
1048     Portupgrade users:
1049     # portinstall databases/postgresql13-server databases/postgresql13-contrib
1050     # portupgrade -a
1051
1052   After installing the new PostgreSQL version you need to convert
1053   all your databases to new version:
1054
1055   # su -l postgres -c "/usr/local/bin/initdb --encoding=utf-8 --lc-collate=C -D /var/db/postgres/data13 -U postgres"
1056   # su -l postgres -c "pg_upgrade -b /tmp/pg-upgrade/usr/local/bin/ -d /var/db/postgres/data12/ -B /usr/local/bin/ -D /var/db/postgres/data13/ -U postgres "
1057
1058   Now the migration is finished. You can start PostgreSQL again with:
1059
1060   # service postgresql start
1061
1062   ATTENTION:
1063   1) The default user changed from "pgsql" to "postgres" in 11. The migration steps above now assume
1064      the "postgres" database user and FreeBSD user.
1065   2) See the updating entry 20190829 if you are updating from a release prior to 11.
1066   3) If you use non-default initdb options, you have to adjust the initdb-command accordingly
1067
1068 20211023:
1069   AFFECTS: users of www/node
1070   AUTHOR: bhughes@FreeBSD.org
1071
1072   The www/node port has been updated to Node.js v17.0.0, the latest
1073   upstream release. A new port, www/node16, has been created for the
1074   upcoming v16.x LTS branch. Users wanting to stay on v16.x can replace
1075   www/node with www/node16 with one of the following commands:
1076
1077   # pkg install www/node16
1078     or
1079   # portmaster -o www/node16 www/node
1080     or
1081   # portupgrade -o www/node16 www/node
1082
1083 20211012:
1084   AFFECTS: users of devel/git
1085   AUTHOR: garga@FreeBSD.org
1086
1087   devel/git port was split into multiple sub-ports that depend on devel/git
1088   and install additional files:
1089
1090   - devel/git-cvs - CVS related scripts and man pages
1091   - devel/git-gui - GUI related scripts and man pages
1092   - devel/git-p4  - Perforce related scripts and man pages
1093   - devel/git-svn - Subversion related scripts and man pages
1094
1095   Due to these changes, CVS, GUI, PERFORCE, and SUBVERSION options
1096   as well as gui and svn flavors were removed from the port.
1097