Downloading and Installing Cadena 2.x

This page contains directions for downloading and installing Cadena 2.x using the Eclipse Update Manager.

Below you will find the installation instructions for Cadena 2.x. Before installing Cadena, make sure to read through the System Requirements to make sure your environment is ready and to reduce the number of issues you might have. For more details on installing you can look at the Cadena 2.0: Install Guide. After installing, take a look at the Cadena 2.0: nesC Tutorial, the Cadena 2.0: nesC Manual, the Cadena 2.0: OpenCCM Tutorial, the Cadena 2.0: Manual, and the article about Cadena 2.0 (published in IEEE/Computer) that are provided at the bottom of this page.

Note: When you run into problems, you should take a look at our support policy.

System Requirements


Launch the Update Manager

Eclipse features an elegant mechanism for installing new plug-ins: the Update Manager. By configuring third-party websites as known sources of new software inside the Update Manager, you can allow Eclipse to manage the dependencies, downloading, unpacking, and installation of these sets of packages (called features).

Open the Update Manager's dialog to install new features by choosing Help -> Software Update -> Find and Install... from the main menu.

The Update Manager can, in addition to downloading new packages, also search for upgrades to already-installed features. For now, choose Search for new features to install in the dialog that appears.

The other option (Search for updates to the currently installed features) can be used to update to the latest release of Cadena if you already have a previous version of our Eclipse feature installed.

Configure the Update Manager with Cadena Features

Depending on your prior configuration, Eclipse will already have one or more external websites declared as sources of packages. At a minimum, you should see the main Eclipse Project Updates and Callisto Discovery Site entries. These contain official Eclipse add-on projects. We will now inform the Update Manager of the website at which it can find Cadena features.

First, click New Remote Site.... In the resulting dialog box, enter the following values:

Click OK to dismiss the dialog. The Cadena site should now appear as a checkbox-selectable item in the Sites to include in search list.

Configure the Update Manager to use the Eclipse update site

Cadena depends on two plugins that may not be installed in Eclipse by default: 1) GEF and 2) EMF. Because of this, you should select the Callisto Discovery Site as a site to include in the search of plugins and features to install. If you are using Eclipse 3.1* you may need to use the following section on adding the alternate update site.

Once you have the Cadena update site specified and selected and the Callisto Discovery site selected press Finish. When you do this, Eclipse starts the process of downloading and inspecting the update site contents to see what plugins and features are available.

Configure the Update Manager to use the Alternate Eclipse update site

If you are installing Cadena in Eclipse 3.1*, you may need to use an alternate update site to get the proper versions of GEF and EMF installed. We have found that these versions of EMF and GEF are not available on the main Eclipse update site. Therefore, it will work best for users to use an alternate update site. There is also a note in that talks about alternate ways to get GEF and EMF.

First, click New Remote Site.... In the resulting dialog box, enter the following values:

Click OK to dismiss the dialog. The alternate Eclipse update site should now appear as a checkbox-selectable item on the main Update sites to visit screen.

After adding the Cadena and alternate Eclipse update sites to the Sites to include in search list, select the Alternate update site and the Cadena update site to indicate that some packages from each of these sources will be installed. Now Click Finish and the Update Manager will begin querying these websites to find their current software offerings.

Select Cadena distribution

Once the Update Manager has completed it inspection of the specified update sites it will provide you a list of available features and plugins to install. This is displayed in the Search Results dialog. By expanding the tree, you can view all of the software available on the Cadena update site.

The Core category will always contain the most recent release of Cadena. It may also include other milestone releases of particular noteworthiness and other extensions to the core platform. The Platforms category contains releases of platform extensions to Cadena (the platforms shown will likely include CCM, OpenCCM, and TinyOS).

Choose Cadena (the current release may be more current than the screen capture pictured). Optionally, you may also select any other extensions or platforms to install as well.

Note: Eclipse may require several seconds to process the expansion of a site or category or the selection of a feature. When this happens, the Update Manager downloads and inspects the JAR files providing the sites/features as soon as they are selected. Please be patient and wait for the user interface to again be responsive.

After selecting these checkboxes, you may notice that the Update Manager reports that Cadena cannot be installed because features Cadena depends are not installed. The next step will fix this by selecting required features.

Add Dependencies

Cadena depends on a few features (including GEF and EMF) to be installed before it can be used. If these features are not installed, the Update Manager will display a warning.

To install these required features along with the Cadena installation, click on the Select Required button. This will automatically select all of the necessary features. Note: due to a bug in the current release of Eclipse (3.1.2), it may be necessary to "prime" the feature list by expanding the item before clicking the Select Required button. Otherwise, the required features will not be included in the selection.

After selecting those features you wish to install, click Next to move on.

Before moving on you should ensure that you have the following features selected to be installed:

  • Cadena 2.0.*
  • Cadena Jython 2.0.*
  • Eclipse Modeling Framework (EMF) 2.1.0
  • Graphical Editing Framework (GEF) 3.1.1
After selecting those features, click Next to move on.

Accept License Agreements

In addition to the SAnToS Academic License to which you must agree in order to download and use Cadena, the Eclipse Foundation has its own open-source license which applies to any features from Eclipse. Other library dependencies of Cadena which we bundle in the Cadena core distribution feature also impose their own license terms.

The Feature License screen presents all of these documents. Please read through all of these terms of agreement and, after you are familiar with them to your satisfaction, click Next.

Final Confirmation

Eclipse's Update Manager offers one final chance to review your choices. Click Finish to trigger installation of the features.

Unsigned JAR Warning

While installing the Cadena feature, you may be prompted by a warning which reports that no encryption signature has been used to certify its authenticity. You should still allow installation to proceed despite this condition by clicking Install All.

At this point, all software should be unpacked and installed. You will probably be asked to restart the workbench to make the new plugins active. After doing this, Cadena will be ready to use.


Related Documents