2. Installation

2.1. Windows

2.1.1. Setup Process

The product can be installed by executing the setup.exe (requires administrator privileges) and follow the screen instructions:

Welcome page:
_images/setup.png
License Agreement:
_images/setup_2.png
Select Installation Folder:
_images/setup_3.png
Confirm Installation:
_images/setup_4.png
Installing EC-EngineerWeb:
_images/setup_5.png
Installation Complete:
_images/setup_6.png

2.1.2. Silent Installation (optional)

The product can be also installed in silent mode by using the command line parameters of msiexec.

Sample 1: Installs EC-EngineerWeb into default installation folder

msiexec /i c:/temp/EcEngineerWebSetup.msi /quiet /qn /norestart /log c:/temp/install.log

Sample 2: Installs EC-EngineerWeb into C:/EC-EngineerWeb

msiexec /i c:/temp/EcEngineerWebSetup.msi /quiet /qn /norestart /log c:/temp/install.log INSTALLLOCATION="C:/EC-EngineerWeb"

For more information please refer command line parameters of msiexec.

Note

The system requirements EtherCAT Slave descriptions (ESI files) will be not checked!

2.1.3. File and Folder Structure

The setup process will copy all necessary files into the following folder:

Installation directory: (Default: %ProgramFiles%/acontis_technologies/EC-EngineerWeb)
  • /Doc

    Release notes and the user manual

  • EcEngineerWeb.exe

  • EcMaster.dll

All users directory: ( %ALLUSERSPROFILE%/EC-EngineerWeb, like C:/ProgramData/EC-EngineerWeb)
/CAPTURE

Capture files which can be analysed in offline diagnosis mode (see Capture File)

/EtherCAT

EtherCAT Slave Information ESI Files (can be modified via ESI-Manager)

/EMI

EtherCAT Master Information files (see User Manual EC-Engineer , Chapter EMI Manager)

ESICache.xml

ESI-File-Cache for faster access of ESI files

EC-EngineerWeb.log

Log file

User.myusername.xml

User specific settings

2.1.4. NDIS Driver

The Network Driver Interface Specification (NDIS) is the specification for a network driver architecture that allows transport protocols like TCP/IP to communicate with an underlying physical network adapter. For sending and receiving EtherCAT frames in Windows, EC-EngineerWeb makes use of the well-known Windows packet capture library, WinPcap. However, WinPcap was based on the NDIS 5.x driver model, and development has ceased. The latest versions of Windows 10 do not support this old NDIS 5.x version anymore, so now EC-EngineerWeb (V3.2 and higher) includes an installation package in the install directory of EC-EngineerWeb to install the acontis NDIS 6.x Filter Module EcatNdis.sys. With this new Filter Module and the new NDIS Link Layer emllNdis.dll, it is now possible for EC-EngineerWeb to work without WinPcap on all Windows 10 versions.

Note

Please restart EC-EngineerWeb after the NDIS installation.

_images/architecture.png
_images/image18.png

2.2. Linux

2.2.1. Setup Process Linux

The product can be installed by following the following step:

Extract it e.g. into /opt/EC-EngineerWeb_Linux-x64/ (sudo is required)

Optional
Images are missing you may need to install those libraries:
  • libc6-dev

  • libgdiplus

Dongle version

Install “CodeMeter User Runtime for Linux”: https://www.wibu.com/support/user/downloads-user-software.html

E.g. Ubuntu-x64
  • download the package “Linux 64-bit DEB Package”

  • open context menu and select Open with Ubuntu Software Center and install the package

Run /opt/EC-EngineerWeb_Linux-x64/bin/EcEngineerWeb (sudo is required)

Open default browser and enter http://127.0.0.1:5000

2.2.2. File and Folder Structure Linux

The setup process describes how to install all files into the following folder:

Installation directory: (Default: /opt/EC-EngineerWeb_Linux-x64/)
/bin
  • EcEngineerWeb

  • EcMaster.dll

/doc

Release notes and the user manual

/etc

Linux specific

/EMI
  • EtherCAT Master Information files (see User Manual EC-Engineer , Chapter EMI Manager)

  • EcEngineerWeb.xml

  • User specific settings

/var

Linux specific

/cache
ESICache.xml

ESI-File-Cache for faster access of ESI files

/lib

Linux specific

/EtherCAT

EtherCAT Slave Information ESI Files (can be modified via ESI-Manager)

/log
EcEngineerWeb.log

Log file

2.3. MacOS

2.3.1. Setup Process MacOS

The product can be installed by following the following step:

Extract it e.g. into /Users/username/Desktop/EC-EngineerWeb_MacOS-x64/
Optional
Images are missing you may need to install those libraries:

libgdiplus

Dongle version

Install “CodeMeter User Runtime for mac OS”: https://www.wibu.com/support/user/downloads-user-software.html

Run /Users/username/Desktop/EC-EngineerWeb_MacOS-x64/EcEngineerWeb

Open default browser and enter http://127.0.0.1:5000

2.3.2. File and Folder Structure MacOS

The setup process describes how to install all files into the following folder:

Installation directory: (Default: /Users/username/Desktop/EC-EngineerWeb_MacOS-x64/)
/Doc

Release notes and the user manual

/EMI

EtherCAT Master Information files (see User Manual EC-Engineer, Chapter EMI Manager)

/EtherCAT

EtherCAT Slave Information ESI Files (can be modified via ESI-Manager)

EcEngineerWeb.xml

User specific settings

EcEngineerWeb

EC-EngineerWeb

ESICache.xml

ESI-File-Cache for faster access of ESI files

EcEngineerWeb.log

Log file