About

The following article describes, what you should care about, if you want to upgrade a UML of systemausfall.org from sarge to etch.

Checklist

This is just a very short list of all necessary steps. Further explanations about how to realize these steps are described in the following chapter below.

shutdown the uml, copy the system image and start it again (disable the hueter script meanwhile)
replace stable or sarge with etch in /etc/apt/sources.lst and disable all testing-security lines
apt-get update && apt-get dist-upgrade -- check all changed configuration files carefully and try to install new files whenever possible (to get the updated comments)
did apache2 replace the symlink /etc/apache2/conf.d -> /data/etc/apache2-conf.d (if it existed) with an empty directory? Fix it and restart apache2.
check for to-be-updated broken apache ldap authentication settings (see below for details):
```
grep -lr AuthLDAPUrl /etc/apache2/ $(find / -type f -name .htaccess)
```

Problems & Solutions

Apache2 and LDAP authentication

Since apache2.2 there are some more directives necessary to make our setup work.

Add the following two lines to every ldap authentication entry:

AuthBasicProvider               ldap
AuthzLDAPAuthoritative          Off

You can find all relevant files by running the following command:

grep -lr AuthLDAPUrl /etc/apache2/ $(find / -type f -name .htaccess)

(it takes around one minute to finish the search)