[debian-edu-commits] [Debian Wiki] Update of "DebianEdu/Documentation/Stretch/Upgrades" by WolfgangSchweer

[Debian Wiki]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Debian Wiki" for change notification.

The "DebianEdu/Documentation/Stretch/Upgrades" page has been changed by WolfgangSchweer:
https://wiki.debian.org/DebianEdu/Documentation/Stretch/Upgrades?action=diff&rev1=8&rev2=9

  https://www.debian.org/releases/stretch/releasenotes)
  
  Don't use X, use a virtual console, log in as root.
- Read all debconf information carefully, choose 'keep your currently-installed version'; in most cases hitting return will be fine.
+ Read all debconf information carefully, choose 'keep your currently-installed version' unless stated differently below; in most cases hitting return will be fine.
- Press 'q' to quit the apt-listchanges pager once you've read the information.
+ 
+ Please note one difference between apt and apt-get in Stretch:
+ By default apt-get keeps downloaded packages, apt removes them from the cache (after successful installation).
+ 
+ If {{{apt}}} finishes with an error, try to fix it and/or run {{{apt -f install}}} and then {{{apt -y full-upgrade}}} once again.
  
  === Upgrade the server side ===
  
   * Make sure the current system is up-to-date.
+   {{{
+   apt update
+   apt full-upgrade
+   }}}
  
- {{{
- apt-get update
- apt-get -y upgrade
- }}}
+ If the upgrade breaks due to sitesummary:
+     {{{
+     dpkg -r sitesummary
+     apt -f install
+     apt install sitesummary
+     }}}
  
-  * Do the actual upgrade.
+  * Cleanup the package cache.
+   {{{
+   apt clean
+   }}}
  
+  * Prepare and start the upgrade to Stretch.
- {{{
+   {{{
+   # The profile name has been changed.
+   sed -i 's/Thin-Client-Server/LTSP-Server/' /etc/debian-edu/config
+   # The default mirror has been changed.
+   sed -i 's/http.debian.net/deb.debian.org/g' /etc/apt/sources.list
+   # replace jessie with stretch.
- sed -i 's/jessie/stretch/g' /etc/apt/sources.list
+   sed -i 's/jessie/stretch/g' /etc/apt/sources.list
- apt-get update
+   apt update
- apt-get -y dist-upgrade
- }}}
+   apt full-upgrade
+   }}}	
  
- If {{{apt-get}}} finishes with an error, try to fix it and/or run {{{apt-get -f install}}} and then {{{apt-get -y dist-upgrade}}} once again.
+ apt-list-changes: be prepared for a lot of NEWS to read; press <return> to scroll down, <q> to leave the pager.
+ 
+  * Package configuration.
+   * icinga-cgi: Provide icingaadmin's password (same as used for nagiosadmin)
+   * Just in case several display managers are installed: display-manager: Choose lightdm
+   * Configuring Kerberos Authentication: Enter 'kerberos' as hostname.
+   * Configuring icinga-common: Use external commands with Icinga: Choose <Yes>.
+   * tftp (etc/inetd.conf): Choose <Yes>.
+   * /etc/default/ldap2zone: Choose Y.
+   * /etc/gosa/gosa.conf Choose N.          # Never accept a new gosa.conf version!
+ 
+  * Cope with the Squid3 to Squid renaming.
+   {{{
+   service squid stop #Takes some time!
+   rm -rf /var/spool/squid
+   umount /var/spool/squid3
+   sed -i 's#spool/squid3#spool/squid#' /etc/fstab
+   mv /var/spool/squid3 /var/spool/squid
+   mount -a
+   rm /etc/squid3 -rf
+   rm /etc/default/squid3 -rf
+   }}}	
+ 
+  * Use FQDN for sudo.
+   {{{
+   ldapvi -ZD '(cn=admin)'
+   }}}	
+   (Enter root PW)
+   Search for 'sudoHost :tjener', replace tjener with tjener.intern
+   (Enter 'y' to modify the LDAP data base.)
+ 
+  * Apply and adjust configuration.
+   {{{
+   cfengine-debian-edu -D installation
+   rm /etc/apache2/conf-enabled/nagios3.conf
+   rm /etc/apache2/mods-enabled/userdir.conf
+   sed -i 's/udp4/udp/' /etc/inetd.conf      # Bug 789667 (atftpd)
+   service squid start
+   service apache2 restart
+   }}}	
+ 
+  * Names of metapackages have been changed.
+   {{{
+   apt update
+   apt install education-networked-common
+   apt install education-ltsp-server         # Only if profile 'LTSP-Server' is installed.
+   }}}	
+ 
+  * Get the new Stretch artwork.
+   {{{
+   apt install debian-edu-artwork-softwaves
+   }}}	
+ 
+  * After reboot, do some more cleanup.  
+   {{{
+   apt purge linux-image-3.16.0-4-amd64 
+   apt purge debian-edu-artwork-lines        # Only if not wanted as an alternative theme.
+   dpkg -P php5-imagick
+   rm -rm /etc/php5
+   }}}	
+ 
+  * Enable otherwise broken PHP 7.0 support.
+   {{{
+    a2enmod php7.0                            
+    service apache2 restart
+   }}}	
  
   * Check if the upgraded system works.