Test Engine

Introduction

Test Engine is a set of software components that provide essential features of Test Environment. It is unlikely that you will need to update any of Test Engine components, but more likely you will need to implement some helper libraries that utilize services provided by Test Engine or you will need to add some functionality in te_agents.

High Level decomposition of Test Engine Components

Test Engine consists of the following components:

Dispatcher, which is responsible for configuring and starting of another subsystems;
Builder, which is responsible for preparing libraries and executables for te_agents and TE Subsystems as well as NUT bootable images and building the tests;
Configurator, which is responsible for configuring the environment, providing configuration information to tests and for recovering the configuration after failures. Moreover it supports some TEN-local database used by Test Packages to store shared data;
Remote Control Facility (RCF), which is responsible for starting te_agents and for all interactions between Test Engine and te_agents on behalf of other subsystems and tests;
Tester, which is responsible for running a set of Test Packages specified by a user in the mode specified by a user (one-by-one, simultaneous, debugging);
Logger, which provides logging facilities for Test Environment (Test Engine and te_agents) and tests, and log processing tools for users.

The following diagram gives more detailed information on relations between Test Environment components:

Interconnections of Test Engine components

Builder

Configurator

API Usage: Configurator API

API: Configurator

Configuration backup manipulation
Configuration tree traversal
Configuration tree access operations
Synchronization configuration tree with Test Agent
Test Agent reboot

TAPI: Test API for configuration nodes

ARL table configuration
Agent namespaces configuration
Agents, namespaces and interfaces relations
Bonding and bridging configuration
CPU topology configuration of Test Agents
Command monitor TAPI
DHCP Server configuration
DUT serial console access
Environment variables configuration
Ethernet PHY configuration
Ethernet interface features configuration
IP rules configuration
IPv6 specific configuration
Kernel modules configuration
L2TP configuration
Local subtree access
Manipulation of network address pools
NTP daemon configuration
Neighbour table configuration
Network Base configuration
Network Emulator configuration
Network Interface configuration
Network Switch configuration
Network sniffers configuration
Network statistics access
Network topology configuration of Test Agents
PPPoE Server configuration
Processes configuration
Queuing Discipline configuration
tc qdisc TBF configuration
Routing Table configuration
Serial console parsers configuration
Solarflare PTP daemon configuration
System parameters configuration
TA system options configuration (OBSOLETE)
Test API to handle a cache
VTund configuration
Virtual machines configuration
XEN configuration
iptables configuration

Dispatcher

Logger

API: Logger

API: Logger messages stack

Remote Control Facility (RCF)

API Usage: Remote Control Facility API

API: RCF

API Usage: Remote Procedure Calls (RPC)

Report Generator Tool

Test Results Comparator

Tester