Updating the Satellite Server

In the past, updates to the satellite server were published rarely (usually at the end of a semester) in the form of an OVF image. The ESX admin then had to deploy the new version of the server as a new VM (and if necessary, shut down the old version and save it in case of an error). Since the admin responsible for the satellite server often has no control over the ESX server, an update had to be coordinated between multiple people.

In order to fix errors faster and roll out new functionality more often, a script was made for updating the server. This script allows an update to be performed independently by the satellite server admin.

However, there are some things to keep in mind.

The update overwrites (at least) the following files and directories as well as their contents:

  • /etc/lighttpd/lighttpd.conf
  • /opt/dmsd
  • /opt/ldadp
  • /opt/openslx/ipxe
  • /opt/taskmanager
  • /srv/openslx/tftp
  • /srv/openslx/www/slx-admin

File-level changes (for example, to '/opt/openslx/tftp') made directly on the server should therefore be externally backed up.

Although the update is tested in advance by the bwLehrpool team, it is always recommended to back up the configuration via the web interface and, if necessary, take a snapshot of the server VM. Thus, in the case of an error the previous state can quickly be restored.

Installing Updates

Log in via the console/SSH/Terminal on the satellite server and execute the following commands as 'root'. Replace VERSION by the desired version to update to. As of July 2019, this is 3.8b.

wget "http://files.bwlp.ks.uni-freiburg.de/satellit/bwlehrpool-update-VERSION.sh"
sh "bwlehrpool-update-VERSION.sh"

Output on successful update (Click to expand)

Restart the server once the script has run. After the restart, some background tasks are performed, which may take a few minutes the first time. During this period, clients' PXE boot will fail.

If the clients still have problems with booting or authentication at the login prompt, the system configuration may need to be regenerated under 'Localization + Integration' and set the IP address under 'PXE/Boot' and Click on 'Create boot menu'. The initial generation of the boot menu may take some time after an update.

Updating the Satellite Server OS

The Satellite Server Update does not install system patches or the like. Only bwLehrpool specific modules are updated (web interface, DNBD3, …).

Security updates are automatically installed daily during operation (keyword 'unattended-upgrades'), unless it is, for example, blocked by a firewall. Sometimes updates only become active after a reboot (usually with kernel updates). If a reboot is necessary, the web interface informs the user after login.

All further system updates are in the hands of the Sat-Admins. Theoretically, an updated package can negatively impact the system. Therefore, regular package updates are the responsibility of the Sat Admin and are not performed automatically.