This documentation is no longer maintained. For documentation of the current version of emc2, please see http://www.linuxcnc.org/docview/html

Installing the EMC2 software

Introduction

One of the problems users often complained about EMC was installing the software itself. They were forced to get sources, and compile themselves, and try to set up a RT-patched Linux, etc. The developers of EMC2 chose to go with a standard distribution called Ubuntu ^1.1.

Ubuntu has been chosen, because it fits perfectly into the Open Source views of EMC2:

Ubuntu will always be free of charge, and there is no extra fee for the "enterprise edition", we make our very best work available to everyone on the same Free terms.
Ubuntu comes with full professional support on commercial terms from hundreds of companies around the world, if you need those services. Each new version of Ubuntu receives free security updates for 18 months after release, some versions are supported for even longer.
Ubuntu uses the very best in translations and accessibility infrastructure that the Free Software community has to offer, to make Ubuntu usable for as many people as possible.
Ubuntu is released regularly and predictably; a new release is made every six months. You can use the current stable release or help improve the current development release.
The Ubuntu community is entirely committed to the principles of free software development; we encourage people to use open source software, improve it and pass it on.

EMC Download Page

You will find the most recent releases of EMC2 announced on www.linuxcnc.org. The releases of EMC2 will be done in two ways (sources and binary package). The sources (described in the Developers Handbook) consist of a tarball (emc2-<version>.tar.gz), which you should download and unpack into your home directory.

This document (oriented towards the end-user) will only try to explain how to install the binary package on the Ubuntu distribution^1.2.

EMC2 Live CD

The EMC2 team now has a custom Live-CD based on Ubuntu 6.06 that will let you try out EMC2 before installing, and it's also the easiest way to install Ubuntu and EMC2 together.

Just download the ISO http://linuxcnc.org/iso/emc2-ubuntu6.06-desktop-i386.iso (EU Mirror http://dsplabs.utt.ro/ juve/emc/) and burn it to a CD. (The MD5SUM of the CD is 6ee5048eb9cb424aa030dfedccc5386b)

When you boot the CD on your machine, you can see and experiment with the exact environment and EMC2 software that you will have if you choose to install it.

If you like what you see, just click the Install icon on the desktop, answer a few questions (your name, timezone, password) and the install completes in a few minutes.

This install gives you all the benefits of the community-supported Ubuntu distribution as well as being automatically configured for EMC2. As new Ubuntu updates or EMC2 releases are made, the Update manager will let you know and allow you to easily upgrade.

EMC2 install script

We also provide a simple script to install emc2 on Ubuntu for users with an existing installation of Ubuntu. It runs the commands explained in .

To use it you need to :

Download the script from http://www.linuxcnc.org/emc2-install.sh (for Ubuntu 5.10) or http://linuxcnc.org/dapper/emc2-install.sh (For Ubuntu 6.06)
Save it on your Desktop. Right-click the icon, select Properties. Go to the Permissions tab and check the box for Owner: Execute. Close the Properties window.
Now double-click the emc2-install.sh icon, and select "Run in Terminal". A terminal will appear and you will be asked for your password.
When the installation asks if you are sure you want to install the EMC2 packages, hit Enter to accept. Now just allow the install to finish.
When it is done, you must reboot (System > Log Out > Restart the Computer), and when you log in again you can run EMC2 by selecting it on the Applications > CNC Menu.
If you aren't ready to set up a machine configuration, try the sim-AXIS configuration; it runs a "simulated machine" that requires no attached hardware.
Now that the initial installation is done, Ubuntu will prompt you when updates of EMC2 or its supporting files are available. When they are, you can update them easily and automatically with the Update Manager.

Manual installing using apt commands.

The following few section will describe how to install EMC2 using a console and apt-commands. If you know a bit about Linux and Debian-flavored distributions this might be trivial. If not, you might consider reading .

First add the repository to /etc/apt/sources.list:

$ sudo sh -c 'echo "deb http://www.linuxcnc.org/emc2/ dapper emc2" >>/etc/apt/sources.list;'

$ sudo sh -c 'echo "deb-src http://www.linuxcnc.org/emc2/ dapper emc2" >>/etc/apt/sources.list'

Or replace 'dapper' above with 'breezy' if you still use Ubuntu 5.10 Breezy Badger.

Then update & get emc2.

: $ sudo apt-get update
$ sudo apt-get install emc2

This command will install the emc2^1.3 package along with all dependencies^1.4.

You might get warnings that the packages are from an untrusted source (this means your computer doesn't recognize the GPG signature on the packages). To correct that issue the following commands:

: $ gpg -keyserver pgpkeys.mit.edu -recv-key BC92B87F
$ gpg -a -export BC92B87F | sudo apt-key add -

Footnotes

...Ubuntu ^1.1: ``Ubuntu'' is an ancient African word, meaning ``humanity to others''. Ubuntu also means ``I am what I am because of who we all are''. The Ubuntu Linux distribution brings the spirit of Ubuntu to the software world. You can read more about it at http://www.ubuntu.com
... distribution ^1.2: For information regarding other Linux variants, check the Developers Handbook or ask for help on the emc-developers mailing list http://sourceforge.net/mail/?group_id=6744.
... emc2 ^1.3: AXIS is now part of emc2. You don't need to install emc2-axis as previously.
... dependencies ^1.4: The dependencies are one of the nicest thing in Debian based distributions. They assure you have everything installed that you need. In the case of emc2 it's even a RT-patched kernel, and all needed libraries.

2007-01-21