= Stretch to Buster Upgrade =


Notes and issues are tracked via #15136

== Upgrade ==

These are the general steps if you are NOT upgrading a MOSH (see below for MOSH's), but please read this full page before starting!

{{{
rm /etc/apt/sources.list.d/*
rm /etc/apt/preferences.d/*
sed -i "s/jessie/stretch/" /etc/apt/sources.list
apt update
apt dist-upgrade
gpg --change-passphrase root@$(hostname).mayfirst.org
freepuppet-run
freepuppet-run # again
apt dist-upgrade # again
shutdown -h now # or shutdown -r now for physical hosts
}}}

== Upgrading a mosh ==

Run: `mf-dist-upgrade-mosh`

It will warn you about problems and try to run the entire upgrade with minimal intervention.

== Prompted config files ==

 * /etc/logrotate.d/apache2: Do we still need our customizations of this file?
 * /etc/systemd/journald.conf: The new default file has some changes to commented out things... we should update ours to reflect the changes
 * /etc/systemd/timesyncd.conf: The new default file has some changes to commented out things... we should update ours to reflect the changes
 * /etc/cronttab: THe new default has helpful comments... we should update ours to reflect the changes
 * /etc/logrotate.conf: new defaults keep less logs around, we should update ours to reflect
 * /etc/ssh/sshd_config: I think we have already incorporated these changes
 * /etc/default/postfwd
 * /etc/default/spamassassin

== Next steps ==

 * Examine differences between the new config files and incorporate into puppet as needed
 * Re-write mf-dist-upgrade-mosh
 * Update red control panel to add php 7.3 option and figure out plan to upgrade everyone