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.

3.1. Installation on Linux

On 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.

Root access or administrator privileges are not required in order to install the eCosPro Developer's Kit. However, if installing as root or administrator:

  1. If installing from the console, without a GUI, or from an environment that does not have permission to open a new window when run as root, the installer will fall back into a text installation mode. This text installation mode may also be chosed by running the primary installer with the option --mode text included from the command line.
  2. You must ensure that the users requiring access have appropriate permission to read files from the installed location.
[Note]Note

Current versions of eCosPro installers on Linux systems no longer register eCosPro components with the native Linux package management system.

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

  1. Download the installation pack and extract them into a temporary directory.
  2. Execute the accompanying install.sh script located in the tarball, or the primary installer associated with the eCosPro Developer's Kit. For example:

    /tmp/ecospro-4.1.3-sama5d3x-linux-x64 $ ecospro-4.1.3-sama5d3x-linux-x64-install.run

    The remaining installers will automatically be invoked by the primary installer according to the manifest only if those components are not already installed.

  3. Follow the on-screen instructions of the installer. An example walk-through is illustrated in Chapter 4, Installation Walk-through.

For example: if the tarball archive was called ecospro-4.1.3-sama5d3x-linux-x64.tar, the following set of commands illustrate extracting the archive and invoking the installer:

~ $ cd /tmp
/tmp $ tar -xvf ~/Downloads/ecospro-4.1.3-sama5d3x-linux-x64.tar
ecospro-4.1.3-sama5d3x-linux-x64/install.sh
ecospro-4.1.3-sama5d3x-linux-x64/ecospro-eclipse-1.5.3-linux-x64-install.run
ecospro-4.1.3-sama5d3x-linux-x64/ecoshosttools-4.0.2-linux-x64-install.run
ecospro-4.1.3-sama5d3x-linux-x64/ecospro-gnutools-arm-eabi-4.7.3j-linux-x64-install.run
ecospro-4.1.3-sama5d3x-linux-x64/ecospro-4.1.3-sama5d3x-linux-x64-install.run
ecospro-4.1.3-sama5d3x-linux-x64/ecospro-4.1.3-sama5d3x-linux-x64-install.xml
/tmp $ ecospro-4.1.3-sama5d3x-linux-x64/install.sh

See also Section 3.3, “Installation Tips and Notes”.

3.2. Installation on Windows

The eCosPro Developer's Kit for Windows comprises of a number of separate components. Although each component can be installed and upgraded separately, the normal approach for initial installation is to download the ZIP archive and run the setup.exe Install Launcher to install the complete set of components. Installation can only be achieved from a user account that has administrator privileges.

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

  1. 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 on a local hard drive. Do not download them onto a network drive. If you downloaded the ZIP archive, extract the complete contents of the archive into the temporary directory on the local hard drive.
  2. Execute the accompanying setup.exe program if you downloaded the compressed ZIP archive, or the primary installer associated with the eCosPro Developer's Kit. For example, the primary installer for eCosPro 4.1.3 for various SAMA5D3X platforms is ecospro-4.1.3-sama5d3x-windows-install.exe. If there is more than one primary installer, setup.exe will prompt you for the eCosPro release you would like to install. The remaining installers will automatically be invoked by the primary installer as required.

    If you are installing on Windows 7 or Windows 10, you may get a warning or pop-up such as the one illustrated in Figure 3.1, “Windows 10 Installation Publisher”. In this event, select YES to allow the installer to execute. This pop-up may occur on multiple occassions during the installation process as each component installer is executed in turn. You may also get similar warnings from Anti-Virus applications such as Norton Internet Security or Kaspersky Internet Security (see Figure 3.2, “Example Kaspersky Internet Security Warning”) warning you of Root Shell or keylogger activity, and prompting you whether you would like to continue. In all cases, please allow the installer to continue. These warnings are due to the installer not being recognised by the anti-virus program, or Windows 7 or Windows 10 User Account Control being set to require a high security approval level.

  3. Follow the on-screen instructions of the installer. An example walk-through is illustrated in Chapter 4, Installation Walk-through.

Figure 3.1. Windows 10 Installation Publisher

Windows 10 Installation Publisher

Figure 3.2. Example Kaspersky Internet Security Warning

Example Kaspersky Internet Security Warning

See also Section 3.3, “Installation Tips and Notes”.

3.3. Installation Tips and Notes

[Tip]Tips
  1. If certain components of the eCosPro Developer's Kit are already installed, you only need to download the installers for the components not yet installed and the installer's manifest. The installer's manifest is prefixed with .xml. i.e. The name of the primary installer with a .xml extension instead of .run
  2. On Linux, wWhen you download the installers individually, you must also ensure the execute permission bit of each installer is set. For example:

    /tmp/ecospro-4.1.3-sama5d3x-linux-x64 $ chmod a+rx *.run
  3. Ensure that you have access to the internet as the installers will contact the eCosPro Developer's Kit Portal to obtain the decryption and installation keys associated with your eCosPro Developer's Kit.
  4. If your development host does not have access to the internet, request a licensee file be sent to you by sending an email to . In this event, you must run the primary installer with the additional parameters --promptlicense 1, after which you will be prompted to provide the location of the file during installation.
[Note]Notes
  1. Installers for eCosPro Developer's Kits prior to 4.X require you download your licensee file from the support portal separately and place it in a directory that may be accessed by the installers.
  2. Installers for eCosPro Developer's Kits prior to version 4.X did not contain a manifest nor did executables have a .run extension.