The documentation for Mir is growing and we also have instructions out how to get Mir running on your computer, I wanted to briefly summarize the necessary steps to get Mir up and running and how to go back.
Please be warned that while I tried to carefully document all necessary steps you might end up with a system that doesn’t function as expected and which will require further intervention, a reinstall or might even suffer data loss (most likely during the OS reinstall;). Also, don’t use Mir on a production or public system, as there is at least one security related bug.
1. Upgrade to Saucy Salamander
If you aren’t already on the development version of Ubuntu 13.10 Saucy Salamander you need to upgrade to it:
$> sudo do-release-upgrade -d $> sudo apt-get update $> sudo apt-get dist-upgrade
this step should be pretty straightforward.
2. Uninstall binary drivers
[EDIT] This only applies if you have binary drivers for a Nvidia or ATI GPU installed. If you are on open drivers, happily skip to #3.
There are many ways to install these in the first place, and likewise there are many ways to uninstall them. Here is one way to do it, YMMV.
For ATI GPUs:
$> sudo apt-get remove --purge fglrx*
For NVidia GPUs:
$> sudo apt-get remove --purge nvidia*
3. Install Mir
Now we are getting serious, first add the PPA to the system:
$> sudo add-apt-repository ppa:mir-team/system-compositor-testing
Then update your package list
$> sudo apt-get update
We have to make sure updates in main don’t overwrite packages from the Mir PPA.
Please edit /etc/apt/preferences.d/50-pin-mir.pref with following content:
Package: * Pin: origin "private-ppa.launchpad.net" Pin-Priority: 1001 Package: * Pin: release o=LP-PPA-mir-team-system-compositor-testing Pin-Priority: 1002
Last but not least, install Mir and all relevant packages
$> sudo apt-get dist-upgrade
Mir and all required packages are now installed. You need to restart lightdm which will take you straight back to the login screen and proceed as if nothing has changed (so the theory).
$> sudo restart lightdm
Right now (due to a bug that is almost a feature;) you will recognize that Mir is running by having 2 mouse pointers (HW & SW mouse pointer). This will go away and we will provide you with another more obvious watermark to identify you are running on Mir.You can also simply check if the system compositor process is running:
$> ps afx | grep unity-system-compositor
5. Going Back
There are 2 possibilities to disable Mir on your system, you can either temporarily switch back to run good old X or you can remove all of Mir all together.
Turning Mir on & off temporarily
In order to switch Mir off/on temporarily, one simply needs to manually edit /etc/lightdm/lightdm.conf.d/10-unity-system-compositor.conf
Simply comment the 2nd line out if you want to turn of Mir and go back to X instead
If you want to go back to Mir, well, you know what to do. Any change must be followed by a restart of lightdm from a console/VT in order to take effect.
$> sudo restart lightdm
Removing Mir from your system entirely
Please start with disabling Mir as described in the paragraph above. Then, we need to purge the Mir PPA, uninstall all packages from there and remove the PPA from your sources list. ppa-purge is the tool for that task:
$> sudo ppa-purge ppa:mir-team/system-compositor-testing
you might have to install ppa-purge first via
$> sudo apt-get install ppa-purge
Second, while not required, I do prefer to do another update & upgrade to make sure I am not missing on anything:
$> sudo apt-get update $> sudo apt-get dist-upgrade
6. Known issues
There are many, but we keep fixing them as we find them, here a few highlights:
- VT/console switching does not work – bugs 1193207 and 1192429, note that input is dumped onto the VT and you might reveal sensitive information such as passwords 1102756
- Screen does not go to sleep – bug 1192429
- MultiMonitor does not work yet – not a bug, but a missing feature. I am running Mir on my X220 in a dock in a Mirrored mode with an external display, this seems to work fine