Introduction

The OpenTAP Runner allows for remote starting and control of OpenTAP sessions via NATS. These sessions can create, load, and execute test plans, modify test plan and test step properties, adjust OpenTAP settings, and provide logs and results.

When to use the OpenTAP Runner?

You should consider the OpenTAP Runner if:

Concepts

OpenTAP Runner Communication

The OpenTAP Runner communicates using NATS.io, a high-performance messaging system that provides a simple yet powerful API for building distributed systems and applications.

Alt text

The NATS Server can be an instance that you control, or you can install the NATS Server TapPackage to let OpenTAP Runner start the NATS Server, which is the recommended approach.

To install the NATS Server package, use the following command: tap package install "NATS Server"

After installation, the runner can be started with the command: tap runner start

The Runner can start Runner Sessions. A Runner Session is a process that also communicates on NATS and exposes the APIs to conduct the same functionality as KS8400A PathWave Test Automation. This includes creating, loading, modifying, and executing test plans.

There are two ways to start a Runner Session through the Runner: using an Image or just a simple copy of the Runner installation. An Image is a set of OpenTAP Packages and a set of OpenTAP Repositories from where to fetch the packages.

The simple case where we ask the Runner to start a Runner Session not based on an Image looks like this:

Alt text

The more remote-friendly and flexible solution is to use Images. If you require a Session with a different set of packages than the current Runner installation provides, create an Image in the Runner and then use that Image to start a Runner Session:

Alt text