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 20240620:
   9   AFFECTS: net-mgmt/net-snmp
  10   AUTHOR: markj@FreeBSD.org
  11
  12   The snmpd and snmptrapd daemons now drop privileges by default when started
  13   using the rc scripts provided in the package.  Make sure that snmpd
  14   configuration in /usr/local/share/snmp is readable by the "snmpd" user.  If
  15   you have defined extension scripts in snmpd.conf, make sure that they can be
  16   executed by an unprivileged user.  To revert to the old behavior of always
  17   running as root, set snmpd_sugid="NO" or snmptrapd_sugid="NO" in /etc/rc.conf.
  18
  19   See the snmpd rc script for a hint on how to debug any permission problems
  20   that might arise as a result of this change.
  21
  22 20240615:
  23   AFFECTS: mail/cyrus-imapd25
  24   AUTHOR: ume@FreeBSD.org
  25
  26   The BDB option is disabled by default.
  27
  28   If you are using the berkeley cyrusdb backend, we strongly recommend
  29   that you switch to something other than the berkeley cyrusdb
  30   backend.  If you want to continue using the berkeley cyrusdb
  31   backend, build the cyrus-imapd25 port yourself with the BDB option
  32   enabled.
  33
  34 20240613:
  35   AFFECTS: multimedia/audacios and multimedia/audacious-plugins
  36   AUTHOR: madpilot@FreeBSD.org
  37
  38   Upstream project made qt6 the new default, so the port flavors have
  39   been updated to follow this change.
  40
  41   If you are using the qt6 flavor, you should uninstall it and install
  42   the unflavored package. If you want to keep using the qt5 version it
  43   will be updated automatically to the qt6 version. If you should
  44   uninstall the unflavored package and instal the qt5 version.
  45
  46 20240606:
  47   AFFECTS: users of net-mgmt/unifi8
  48   AUTHOR: ronald@FreeBSD.org
  49
  50   The default MongoDB version dependency has been switched from 5.0 to 6.0.
  51   Although MongoDB 5.0 -> MongoDB 6.0 datafiles in-place upgrade seem to
  52   work, users are strongly recommended to take full backup of unifi
  53   database prior to upgrade and start with clean installation afterwards.
  54
  55   For an in-place upgrade it is important that the MongoDB
  56   'featureCompatibilityVersion' is set to 5.0.
  57   See: https://www.mongodb.com/docs/v6.0/release-notes/6.0-upgrade-standalone/#feature-compatibility-version
  58   Run these commands in mongodb50 before upgrading (e.g. while unifi is running):
  59   $ mongo --port 27117
  60   > db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )
  61   > exit
  62
  63   See updating entry 20230310 for a backup/restore upgrade.
  64
  65 20240604:
  66   AFFECTS: net-mgmt/net-snmp
  67   AUTHOR: markj@FreeBSD.org
  68
  69   The net-snmp port's newsyslog(8) configuration has been updated such
  70   that the snmpd log file will be owned by the snmpd user following log
  71   rotation.  This is done to make it easier to run snmpd as the snmpd
  72   user rather than as root, using the snmpd_sugid rc.conf option.
  73   For now snmpd still runs as root by default.  This is expected to change
  74   in the future.
  75
  76 20240529:
  77   AFFECTS: users of TeX*
  78   AUTHOR: bofh@FreeBSD.org
  79
  80   TeX system has been updated to 2024 from 2023. Normal pkg upgrade or
  81   portmaster -a should handle all the upgrade properly. In case not please
  82   create a ticket or send a mail to tex@FreeBSD.org
  83
  84   Previously users have reported to delete texlive-texmf prior to
  85   starting update, or pkg-static will indicate there is a conflict
  86   during the upgrade of texlive-base :
  87
  88   # pkg remove texlive-texmf
  89
  90 20240529:
  91   AFFECTS: users of python
  92   AUTHOR: rm@FreeBSD.org
  93
  94   The default version of python3 and python was switched to 3.11.
  95
  96   For ports users wanting to keep version 3.9 as default,
  97   add DEFAULT_VERSIONS+= python=3.9 python3=3.9 to make.conf
  98
  99   Following procedures may ease the upgrade:
 100
 101   For users of pre-build packages:
 102   # sh
 103   # for i in $(pkg query -g %n 'py39-*'); do pkg set -yn ${i}:py311-${i#py39-}; done
 104   # pkg upgrade
 105
 106   For portmaster users:
 107   # sh
 108   # portmaster -o lang/python311 python39
 109   # REINSTALL="$(pkg info -oq '*py39*')"
 110   # pkg delete -f "*py39*"
 111   # portmaster $REINSTALL
 112   # REBUILD=$(pkg query -g "%n:%dn" '*' | grep py3 | grep -v py311 | cut -d : -f 1 | sort -u)
 113   # portmaster $REBUILD
 114   # REBUILD2=$(pkg list | grep python-39 | xargs pkg which | awk '{print $6}' | sort -u)
 115   # portmaster $REBUILD2
 116
 117   Final steps (for pre-built packages & portmaster):
 118
 119   If no longer required, Python 3.9 can be removed via
 120   "pkg remove python39" and the directory /usr/local/lib/python3.9 can
 121   then be deleted afterwards, if not empty.
 122
 123 20240522:
 124   AFFECTS: net-p2p/transmission-daemon
 125
 126   The web interface has been separated from the daemon port into its own port.
 127   This allows users of transmission-gtk and transmission-qt to install the web
 128   interface.
 129
 130 20240521:
 131   AFFECTS: www/gitlab
 132   AUTHOR: mfechner@FreeBSD.org
 133
 134   Make sure you upgrade first to 16.11.x before you upgrade to the today
 135   released version 17.0.0.
 136
 137   For more details see:
 138   https://gitlab.fechner.net/mfechner/Gitlab-docu/-/blob/master/update/16.11-17.0-freebsd.md
 139
 140 20240517:
 141   AFFECTS: comms/tio
 142   AUTHOR: diizzy@FreeBSD.org
 143
 144   As of 3.1 upstream have reworked configuration file layout and syntax
 145   so older configurations will not work.
 146
 147   For more details, see
 148
 149   https://github.com/tio/tio/releases/tag/v3.1
 150
 151 20240513:
 152   AFFECTS: users of security/libressl
 153   AUTHOR: brnrd@FreeBSD.org
 154
 155   The port has been updated to the latest stable version 3.9 of LibreSSL.
 156   The shared library versions of the libraries have been bumped.
 157
 158   After upgrading, manually update all packages that depend on any of the
 159   libraries provided by LibreSSL (libssl, libcrypto and libtls) since the
 160   versions of these libraries have changed. Normally, you can obtain the
 161   list of dependent software by running the following command:
 162
 163   # pkg info -r libressl
 164
 165   Then you should rebuild all ports depending on libressl to avoid dangling
 166   shared library dependencies.
 167
 168 20240509:
 169   AFFECTS: databases/timescaledb
 170   AUTHOR: kbowling@FreeBSD.org
 171
 172   The Foreign Key storage in hypertables has changed in an incompatible way,
 173   after runing ALTER EXTENSION, you must run the SQL script here:
 174   https://github.com/timescale/timescaledb-extras/blob/master/utils/2.15.X-fix_hypertable_foreign_keys.sql
 175
 176   For more details, see
 177
 178   https://github.com/timescale/timescaledb/pull/6797
 179
 180 20240508:
 181   AFFECTS: www/oauth2-proxy
 182   AUTHOR: netchild@FreeBSD.org
 183
 184   The start script is converted to be instance aware.  To use it:
 185    - cp /usr/local/etc/oauth2-proxy.cfg.sample /usr/local/etc/oauth2-proxy-myapp.cfg
 186    - vi /usr/local/etc/oauth2-proxy-myapp.cfg
 187    - ln -s oauth2_proxy /usr/local/etc/rc.d/oauth2_proxy_myapp
 188    - sysctl oauth2_proxy_myapp_enable=YES
 189    - service oauth2_proxy_myapp start
 190   This allows to easily start multiple instances on the same system.
 191
 192   As part of this, the start script was renamed to oauth2_proxy. This only
 193   affects manual restarts, no change in rc.conf is needed.
 194
 195 20240430:
 196   AFFECTS: audio/py-pyradio
 197   AUTHOR: nivit@FreeBSD.org
 198
 199   The new version of Pyradio moves some data files to new locations.
 200   To see what it really does, run pyradio from a terminal the first time.
 201   Besides that, the recordings are moved/saved into ~/pyradio-recordings.
 202   You can change that directory in the config file.
 203
 204   For more details, see
 205
 206   https://github.com/coderholic/pyradio/releases/tag/0.9.3
 207
 208 20240423:
 209   AFFECTS: textproc/vale
 210   AUTHOR: bofh@FreeBSD.org
 211
 212   When upgrading to v3.0.0, the vocabularies need to be moved from
 213   $StylesPath/Vocab to $StylesPath/config/vocabularies.
 214
 215 20240421:
 216   AFFECTS: www/gitlab-ce
 217   AUTHOR: mfechner@FreeBSD.org
 218
 219   With the upgrade to version 16.11 the default path for gitlab-ce changed:
 220   /usr/local/www/gitlab-ce -> /usr/local/www/gitlab
 221   Make sure you follow the upgrade manual very carefully:
 222   https://gitlab.fechner.net/mfechner/Gitlab-docu/-/blob/master/update/16.10-16.11-freebsd.md
 223
 224   The gitlab port also got a new flavor gitlab@ee to make the Gitlab
 225   Enterprise Edition available (you will need a license for it).
 226   Please note, that the ee flavor is a draft, but any feedback is welcome.
 227   See also the installation and upgrade manual for more details.
 228   https://gitlab.fechner.net/mfechner/Gitlab-docu/-/blob/master/install/16.11-freebsd.md
 229
 230 20240408:
 231   AFFECTS: users of databases/p5-DBD-mysql
 232   AUTHOR: flo@FreeBSD.org
 233
 234   Upstream removed support for MariaDB from the 5.0 branch. So if you use
 235   MariaDB you need to use databases/p5-DBD-mysql4 from now on.
 236
 237   Portmaster users:
 238         portmaster -o databases/p5-DBD-mysql4 databases/p5-DBD-mysql
 239         portmaster -a
 240
 241   Portupgrade users:
 242         portupgrade -o databases/p5-DBD-mysql4 -f databases/p5-DBD-mysql
 243         portupgrade -a
 244
 245 20240330:
 246   AFFECTS: users of mail/spamassassin
 247   AUTHOR: cy@FreeBSD.org
 248
 249   sa-update must be run following update and prior to restarting sa-spamd
 250   else it will fail to start due to a syntax error.
 251
 252 20240326:
 253   AFFECTS: users of net/bird2
 254   AUTHOR: olivier@FreeBSD.org
 255
 256   The net/bird2 default flavor has ben switched to netlink on FreeBSD >= 14.0
 257   There is not change for FreeBSD < 14.0 (default flavor is still rtsock)
 258
 259 20240319:
 260   AFFECTS: users of net/rdist6
 261   AUTHOR: cy@FreeBSD.org
 262
 263   As of 52032b3d50c0 net/rdist6 will install its binary named rdist instead
 264   of rdist6. Base FreeBSD no longer has its own rdist binary. Therefore
 265   there is no need to rename the rdist6 binary to rdist6 to avoid confusion.
 266   The historical and default name of the rdist binary is "rdist".
 267
 268 20240318:
 269   AFFECTS: users of net-mgmt/unifi8
 270   AUTHOR: otis@FreeBSD.org
 271
 272   The default MongoDB version dependency has been switched from 4.4 to 5.0.
 273
 274   Although MongoDB 4.4 -> MongoDB 5.0 datafiles in-place upgrade seem to
 275   work, users are strongly recommended to take full backup of unifi
 276   database prior to upgrade and start with clean installation afterwards.
 277
 278   See updating entry 20230310 for details.
 279
 280 20240316:
 281   AFFECTS: users of net/rabbitmq
 282   AUTHOR: dch@FreeBSD.org
 283
 284   In preparation for upgrading to future RabbitMQ releases, users *must*
 285   enable all feature flags before upgrading stepwise to v3.12.13, to be
 286   able to migrate later to v3.13.0 when it is released in 2024Q2.
 287
 288   See https://www.rabbitmq.com/docs/upgrade for details.
 289