Attention

You are viewing an older version of the documentation. The latest version is v3.3.

Setting up ECI Build

The section is applicable to:

_images/linux5.png

Follow these steps to set up a Linux build system to build an ECI image:

  1. Copy the eci-release.tar.gz archive from the ECI release archive (release-eci_#.#.zip) to the Linux build system. Make sure that there are no spaces in the directory path. For example, copy the archive to ~/Desktop. The eci-release.tar.gz archive is located in the ECI release archive within the Edge-Controls-for-Industrial directory as follows:

    └── Edge-Controls-for-Industrial
        ├── Codesys_Example_Applications.zip
        ├── Dockerfiles.tar.gz
        └── eci-release.tar.gz
    
  2. Extract the archive. In Ubuntu, right-click the archive and select “Extract Here”.

    _images/0113.png

    Navigate to the extracted eci-release directory.

    _images/0213.png
  3. Open a terminal to the eci-release directory. In Ubuntu, right-click anywhere in the directory explorer and select “Open in Terminal”.

    _images/C.png
  4. At the terminal prompt, run the provided setup script without any parameters:

    $ ./setup.sh
    
    _images/04.png

    If any of the build dependencies are missing, the script will prompt to install them.

    _images/066.png

    To install the missing dependencies, run the following command, at the terminal, replacing <dependencies> with the packages identified in the prompt:

    $ sudo apt-get update && sudo apt-get -y install <dependencies>
    
    _images/074.png

    The message Filename length test failed! Could not create filename with length of 200 characters might be displayed when the script is unable to create long filenames. Typically, this limitation is a result of filesystem encryption. To resolve this issue, move the entire eci-release directory to a non-encrypted location (that is, root /).

    _images/J1.png

After setting up, if you have a prebuilt image, follow the section Installing ECI Images. If you do not have a prebuilt image, follow the section Building ECI to build the ECI image.