Setup

System Requirements

EHANDBOOK Container-Build Tools are 64-bit applications. The Windows version works on Microsoft Windows 10 and 11 with 64-bit versions. The Linux version works on Ubuntu 20.04 (64-bit). The tools require a minimum 8 GB available RAM. An SSD is highly recommended to speed up file I/O operations. 16 GB RAM or more may be required for processing complex models and huge amount of texts and graphics. If Simulink mask generation is required, a multi-core CPU with many cores is recommended. Please refer to chapter Mask Image Gen for details.

The amount of RAM EHANDBOOK Container-Build is allowed to use is configured in the eHandbookCB.ini file. Please refer to chapter RAM Usage for details.

Download

The EHANDBOOK Container-Build Tools can be downloaded from the ETAS download server.

Installation

EHANDBOOK Containber-Build tools are delivered as a ZIP archive (Windows, extension .zip) and a tarball (Linux, extension .tar.gz). Any Zip file management tool (e.g., 7zip or WinZip) can be used to unzip the contents to a local directory. Likewise, the contents of the tarball can be extracted using the tar utility on Linux based systems.

Further tool installation is required for EHANDBOOK Container-Build versions with an electronic license, see License Management Installation.

The user must have full access rights to the installation directory. Typically, this is not the case for the directory “Program Files”. In this case, use an alternative directory such as c:\ETAS...

Please check, if any optional prerequisite software installation is required before you start the tool (see chapter Additional Third Party Tools).

Windows

The ZIP archive is named as EHANDBOOK-Container-Build_x.y.z_[TAG].zip for Windows.

The following list provides an overview of the contents after extraction:

configuration
documentation
examples
features
icons
jre
p2
plugins
artifacts.xml
eHandbookCB.exe
eHandbookCB.ini

eHandbookCB.exe is the application executable which is used to create the EHANDBOOK container.

Linux

For installation under Linux, the archive is named as EHANDBOOK-Container-Build_x.y.z_[TAG].tar.gz.

The following list provides an overview of the contents after extraction:

artifacts.xml
configuration
documentation
eHandbookCB
eHandbookCB.ini
examples
features
icons
jre
license
p2
plugins

eHandbookCB is the application executable which is used to create the EHANDBOOK container.

Common for Windows and Linux

The documentation/oss_licenses folder contains the necessary open source license information of various components, which are part of the EHANDBOOK Container-Build.

The examples folder contains sample files in corresponding sub folders for container configuration and text styling. Their usage is described in the following chapters.

Electronic Licenses

In order to use the license protected features of EHANDBOOK Container-Build, you must register your license keys with the ETAS License Manager.

EHANDBOOK Container-Build software is protected by electronic license keys. To operate EHANDBOOK Container-Build tools, please ensure that your license keys are installed appropriately.

License Features Overview

The following table provides an overview of the EHANDBOOK Container-Build license features.

Depending on your input sources, only a subset of the features are typically required.
For generating EHANDBOOK Containers, one of the two EHANDBOOK Container-Build Base Frameworks (ASAM or Directory-based) is required.

License Feature	Description
EHB_CB_BASE_ASAM	EHANDBOOK Container-Build Base Framework with converters for ASAM-based sources (ASAM CC, FSX and MDX).
EHB_CB_BASE_DIR	EHANDBOOK Container-Build Base Framework with converters for Directory-based sources (AsciiDoc/RTF, Excel).
EHB_CB_MDL_ASCET	EHANDBOOK model converter for ETAS ASCET. The model converter is an add-on for a EHANDBOOK Container-Build base framework.
EHB_CB_MDL_SIMULINK	EHANDBOOK model converter for Simulink/Stateflow. The model converter is an add-on for a EHANDBOOK Container-Build framework.
EHB_CB_MDL_CCODE	EHANDBOOK model converter for C-Code. The model converter is an add-on for a EHANDBOOK Container-Build framework.
EHB_CB_PDFGEN	EHANDBOOK PDF generator. The PDF generator is an add-on for a EHANDBOOK Container-Build framework.
EHB_CB_UGG_ASCET	EHANDBOOK Unified Graphics Generator (UGG) for ETAS ASCET. UGG is a stand-alone tool to pre-generate SVG graphics and interactive model data that is later processed by an EHANDBOOK Container-Build base framework.
EHB_CB_UGG_SIMULINK	EHANDBOOK Unified Graphics Generator (UGG) for Simulink/Stateflow. UGG is a stand-alone tool to pre-generate SVG graphics and interactive model data that is later processed by an EHANDBOOK Container-Build base framework.
EHB_CB_UGG_CCODE	EHANDBOOK Unified Graphics Generator (UGG) for C-Code. UGG is a stand-alone tool to pre-generate SVG graphics and interactive model data that is later processed by an EHANDBOOK Container-Build base framework.
EHB_CB_CON_AUTOSAR_CLASSIC	EHANDBOOK converter for AUTOSAR (Classic). The converter is an add-on for an EHANDBOOK Container-Build base framework.

License Feature

Description

EHB_CB_BASE_ASAM

EHANDBOOK Container-Build Base Framework with converters for ASAM-based sources (ASAM CC, FSX and MDX).

EHB_CB_BASE_DIR

EHANDBOOK Container-Build Base Framework with converters for Directory-based sources (AsciiDoc/RTF, Excel).

EHB_CB_MDL_ASCET

EHANDBOOK model converter for ETAS ASCET. The model converter is an add-on for a EHANDBOOK Container-Build base framework.

EHB_CB_MDL_SIMULINK

EHANDBOOK model converter for Simulink/Stateflow. The model converter is an add-on for a EHANDBOOK Container-Build framework.

EHB_CB_MDL_CCODE

EHANDBOOK model converter for C-Code. The model converter is an add-on for a EHANDBOOK Container-Build framework.

EHB_CB_PDFGEN

EHANDBOOK PDF generator. The PDF generator is an add-on for a EHANDBOOK Container-Build framework.

EHB_CB_UGG_ASCET

EHANDBOOK Unified Graphics Generator (UGG) for ETAS ASCET. UGG is a stand-alone tool to pre-generate SVG graphics and interactive model data that is later processed by an EHANDBOOK Container-Build base framework.

EHB_CB_UGG_SIMULINK

EHANDBOOK Unified Graphics Generator (UGG) for Simulink/Stateflow. UGG is a stand-alone tool to pre-generate SVG graphics and interactive model data that is later processed by an EHANDBOOK Container-Build base framework.

EHB_CB_UGG_CCODE

EHANDBOOK Unified Graphics Generator (UGG) for C-Code. UGG is a stand-alone tool to pre-generate SVG graphics and interactive model data that is later processed by an EHANDBOOK Container-Build base framework.

EHB_CB_CON_AUTOSAR_CLASSIC

EHANDBOOK converter for AUTOSAR (Classic). The converter is an add-on for an EHANDBOOK Container-Build base framework.

The following image shows the corresponding license features in the ETAS License Manager.

Overview on licensed features of EHANDBOOK Container-Build

Evaluation Licenses

You can evaluate all EHANDBOOK tools to check the suitability for your needs. To start your free evaluation, go to http://license.etas.com and choose the product you want to evaluate.

To download an ETAS software, you need an account for the ETAS Download Server. If you do not have an account yet, you can easily create one.
Evaluations are limited to 2 months. If you need support during your evaluation or need to extend your evaluation, please get in touch with our local ETAS office.

License Management Installation

Windows

In a Windows based system, please run the following installer once for adding your license configuration to the Windows registry.

The following steps are required:

Run EHANDBOOK-Container-Build_x.x.x_License-Management_setup.exe (shipped as separate installer with CB)

Start the ETAS License Manager
Go to Menu → Device → Online Activation

Place the provided Activation ID

Verify license installation in ETAS License Manager. Depending of your license, you will see only some elements of these:

Windows Silent Installation

The License Manager installation can be invoked in silent mode by executing the installer from command line and by specifying additional parameters (see table below).

Installation Scenario Command

Installation Scenario	Command
Silent installation through command line	`EHANDBOOK-Container-Build_x.x.x_License-Management_setup.exe /S`

Silent installation through command line

EHANDBOOK-Container-Build_x.x.x_License-Management_setup.exe /S

Customization of License Configuration file

Customizing the license configuration file is possible by mentioning the path to the licensing.ini file:

/LicenseConfigurationFile=<Path to Licensing.ini>

Example: /LicenseConfigurationFile=D:\licensing.ini

Linux

In a Linux based system, please run the following shell script once to install ETAS License Manager:

Run License_Management_setup.sh with administrative permissions (Located in "license" subfolder in the CB installation folder)

Copy your license file to /usr/share/ETAS/LiMa/CommonLicensePath (for all users) or $HOME/ETAS/LiMa/UserLicensePath (current user)
You can also customize those locations by changing the configuration in /etc/etas/lima/LiMa.ini (CommonLicensePath and UserLicensePath)

Additional Third Party Tools

EHANDBOOK Container-Build uses few third party tools for model, image and TeX formula conversions which are not part of this software package.

PDF FLY

Tool vendor: Visual Integrity Technologies LLC

Link: https://visual-integrity.com/products/pdf-fly-pdf-conversion-suite/

Minimum Tool Version: 9.0.5

As standard EHANDBOOK Container-Build expects all graphics in .svg or raster formats (i.e., .jpeg, .bmp or .png). However, if images referenced in the FSX file are provided in PostScript or Encapsulated PostScript (.ps or .eps) format, the tool PDF FLY is required to transform it into .svg.

MiKTeX

Tool Provider: MikTex

Link: http://miktex.org

Required Tool Version: 2.9

MiKTeX is required, if TeX formula expressions are present in FSX files. It dissolves the TeX expressions and transforms them into .eps format. These .eps are sent to PDF FLY tool to generate .svg images then.

As all formula elements will be transformed into polylines and clip-paths they will not have any textual information and hence are not selectable/searchable later on in EHB-NAV.

MATLAB

Tool vendor: The MathWorks, Inc.

Required Tool Version: see System Requirements

For advanced styling of some Simulink blocks (e.g. masks) MATLAB connection during container build process is required. If multiple versions of MATLAB are installed and no command line parameter is given, the latest installed will be used.