Warning! This page is a draft. TLD 2019.01 is not released yet!

Upgrading to TLD Linux 2019.01

Note: only upgrade from TLD Linux 2018.02 is supported. If you are running TLD Linux 2018.01 please use this howto.

Getting started


Please backup at least entire system configuration before proceeding! If possible, backup entire host or take snapshot of its current state if its virtual machine.

First of all update your poldek indexes:

poldek --upa

Now get rid of all *.rpmnew files from /etc to be sure you will have newest default configurations for all packages for which old one cannot be adjusted or updated.

You should remove all the packages that are no longer part of TLD or your upgrade may be blocked by unresolved package dependencies. Following script will create list of these packages for you:

#!/bin/sh

rpm -qa --qf="%{name}\n" > installed_packages.txt
poldek --cmd "ls --qf=%{name}\n" > dist_packages.txt
sed -i -e 's/\+/\\\+/g;' installed_packages.txt

rm -f removed_packages.txt
for pkg in $(cat installed_packages.txt); do
  if ! grep -q -E "^"$pkg"$" dist_packages.txt; then
    echo "$pkg" >> removed_packages.txt
  fi
done

rm -f installed_packages.txt dist_packages.txt

Carefully inspect contents of file removed_packages.txt created by above script to see what packages must be removed. Warning! If your system has default PHP version installed all PHP packages will be removed due to package name changes. Be sure to backup your PHP configuration before continuing and check upgrade notes for PHP.

When ready remove packages with:

rpm -ev --nodeps $(cat removed_packages.txt)

Upgrading


Warning! TLD 2019.01 brings some changes that may prevent your services from running correctly!

Perform system upgrade:

poldek -v --nohold --upgrade-dist

If you'll run into some unresolved dependencies you may try following things:

1. Remove problematic package. If it hauls half of your system use:

rpm -e --nodeps pakcage

2. Do forced upgrade of problematic package via poldek command line:

poldek --cmd "upgrade --force package"

Add –nodeps if necessary.

Finishing


When upgrade is finished please follow below package notes to get everything running.

Notes for some packages


Mail and FTP daemons, OpenSSL

In TLD 2019.01 we moved away from old style /etc/mail and /etc/ftpd configuration directories shared among multiple daemons. Every package now has its own configuration directory. Additionally we moved openssl configuration to /etc. All configurations should be migrated automatically during upgrade, but it is recommended to check manually if everything is ok. Below you will find list of all affected daemons:

exim: /etc/mail changed to /etc/exim
openssl: /var/lib/openssl changed to /etc/openssl
postfix and postgres: /etc/mail changed to /etc/postfix
proftpd: /etc/ftpd changed to /etc/proftpd
pure-ftpd: /etc/ftpd changed to /etc/pure-ftpd
vsftpd: /etc changed to /etc/vsftpd
spamassassin: /etc/mail/spamassassin changed to /etc/spamassassin

Grub

TLD 2019.01 contains updated version of Grub bootloader. It is good idea to reinstall Grub on your system to upgrade.

© TLD Linux