Upgrading CSAIL Ubuntu LTS versions

Current LTS Release: 16.04

Previous LTS Release: 14.04

Upgrading from the previous Ubuntu LTS release to the current one is possible via the upgrade script provided by TIG. At this point in time, the GUI software updater is not capable of handling the upgrade cleanly due to some bugs in packaged versions of LaTeX. The general upgrade procedure which is handled by our upgrade script is as follows:

  1. Stop the puppet configuration management service
  2. Uninstall the texlive-* packages
  3. Disable third party apt repositories in /etc/apt/sources.list.d which are not tested by TIG
  4. Run the do-release-upgrade script
  5. Re-enable and run the puppet service post-upgrade
  6. Reboot

General Recommendations


Note that newer clean installations of CSAIL Ubuntu provide a much nicer partitioning scheme (no tiny /boot partition, and and a 64GB root partition on disks which support it). If running out of disk space is an issue for you, you should strongly consider a clean installation. Taking a backup and performing a clean installation is the recommended course for installations where the root partition is 16GBs or less.

The upgrade script will try to disable 3rd party repositories which are not tested by TIG. However, this does not attempt to disable custom sources you've added to /etc/apt/sources.list (only the sources.list.d directory). You should disable any apt sources you've added to /etc/apt/sources.list before proceeding with the upgrade. You can re-enable these after the upgrade by changing the release keyword to the new release codename (run lsb_release -c to determine the new codename after upgrading).

It is usually best to perform all software updates before upgrading. Run sudo apt-get update && sudo apt-get upgrade before starting the upgrade.

Lastly, it's recommended that you wait to upgrade your workstation/server until there's ample time to fix issues that crop up during the upgrade. If you have a deadline tomorrow, today is probably not a good time to upgrade! smile


It is highly recommended that you perform a backup of any local data that you have on your boot disk. While there isn't anything in the upgrade process that should cause data loss, if something goes wrong during the upgrade process, performing a clean installation of CSAIL Ubuntu will be the recommended course of action.


If you are upgrading a persistent volume-backed Openstack instance, you should create a snapshot of your boot disks' Openstack volume before proceeding.
Topic revision: 17 Nov 2017, SteveRuggiero

MIT Computer Science and Artificial Intelligence Laboratory


  • About CSAIL
  • Research
  • News + Events
  • Resources
  • People

This site is powered by Foswiki MIT: Massachusetts Institute of Technology