Chapter 3. Installing

The installation process unpacks encrypted and compressed archives into a selected target directory. The contents of these archives vary from source code files and host applications through to HTML and PDF documentation. The primary eCosPro installers also create menu items within a new menu group. Each menu item is a shortcut either to various applications, such as the eCos Configuration Tool and Eclipse, or to documentation, or to a preconfigured shell environment.

The installer tracks all the files unpacked using a hidden file located in the top-level install directory. This allows the uninstaller to remove unmodified files during uninstallation, leaving modified and new files and directories behind. Do not modify or delete this file. Doing so will prevent the uninstaller from uninstalling correctly.

Installation on Linux

For Linux hosts, each component within an eCosPro Developer's Kit is provided as an installer executable which must be run on the host platform. The installer will extract the contents of each component into the specified installation location. In addition, and dependent on the Linux distribution and the packages installed, the component will be also registered through the native Linux package management system. For example, RPM will be used for Red Hat, Fedora and openSUSE distributions; and dpkg will be used for Debian and Ubuntu distributions. For RPM-based installations, rpmbuild must be installed on the host in order for the rpm to be successfully registered - this in turn comes from the rpm-build RPM which you must install beforehand.

If neither rpm-build nor dpkg are installed, the component(s) will still be installed by unpacking the encrypted and compressed tarball into the selected target location. This unpacking is also done for dpkg and RPM-based installations.

Root access or administrator privileges are required in order to install the eCosPro Developer's Kit. If sudo is correctly installed or administrator access correctly set up on the host, the installer will prompt the user for the root or administrator password when required. Otherwise you must start the installation process as root or an administrator.

The steps necessary to install an eCosPro Developer's Kit on Linux are:

  • Download all the components of the eCosPro Developer's Kit that are not already installed on your system and place them into a common temporary directory. If you downloaded the compressed tarball archive, extract the complete contents of the archive into the temporary directory.

    For example, if the tarball archive was called ecospro-3.1.2-zoom-l138-l.tar.bz2, the following set of commands would extract the archive:

    % mkdir tmp-extract
    % cd tmp-extract
    % tar -xjf <path-to-downloaded-file>/ecospro-3.1.2-zoom-l138-l.tar.bz2

    Run man tar from a shell for details of running tar.

  • If you downloaded individual installer components for a Linux host, you must ensure the execute permission bit of each installer is set. For example:

    $ chmod a+rx ecospro-3.1.2-zoom-l138-Linux-x86-setup
  • Place the licensee file you downloaded from the support portal, or were emailed, in a directory that may be accessed by the installers.

  • Execute the accompanying script if you downloaded either the tarball or compressed tarball archives, or the primary installer associated with the eCosPro Developer's Kit. For example:

    test@ubuntu:/tmp/setup$ ./ecospro-3.1.2-zoom-l138-Linux-x86-setup

    The remaining installers will automatically be invoked by the primary installer should those components not already be installed.

  • Follow the on-screen instructions of the installer. An example walk-through is illustrated in Chapter 4.

Once installed, native package management tools may be used to query the package information. Examples are illustrated in Figure 3-1 and Figure 3-2

Figure 3-1. RPM Package Query Example

[root@qa4 Linux-x86]# rpm -qi ecospro-zoom-l138-3.1.2-2
Name        : ecospro-zoom-l138               Relocations: (not relocatable)
Version     : 3.1.2                           Vendor: eCosCentric Limited
Release     : 2                               Build Date: Tue 08 Mar 2011 17:01:16 GMT
Install Date: Tue 08 Mar 2011 17:01:17 GMT    Build Host:
Group       : Applications                    Source RPM: ecospro-zoom-l138-3.1.2-2.src.rpm
Size        : 0                               License: eCosPro,GPL+Exception
Signature   : (none)
Packager    :
Summary     : eCosPro for the Logic Zoom eXperimenter OMAP L138 board
Description :
eCos is a highly configurable royalty-free open source real-time operating
system (RTOS). This eCosPro Developer's Kit package includes eCos run-time
source code, documentation and host tools required to configure the RTOS. The
components of this eCos distribution are governed by a range of software
licenses. Unless otherwise identified, each source code file describes
within itself the license that applies to it and any resulting binary or
object form or derivative of the software.
[root@qa4 Linux-x86]#

Figure 3-2. Synaptic Package Manager Example

Documentation license for this page: eCosPro License