OpenTAP

# Getting Started

This is the official OpenTAP documentation for users and developers.

# What is OpenTAP

OpenTAP is an Open Source project for fast and easy development and execution of automated tests.

OpenTAP is built with simplicity, scalability and speed in mind, and is based on an extendable architecture that leverages .NET. OpenTAP offers a range of sequencing functionality and infrastructure that makes it possible for you to quickly develop plugins tailored for your automation needs – plugins that can be shared with the OpenTAP community through the OpenTAP package repository.

Learn more about OpenTAP here (opens new window).

We recommend that you download the Developer's System (opens new window) provided by Keysight Technologies available with a commercial or community license. The Developer's System is a bundle that contains the SDK as well as a graphical user interface and result-viewing capabilities.

# Install OpenTAP

# Windows

  1. Download the installer (opens new window).
  2. Start the installer.

# Linux

Note: Dotnet installed using Snap (opens new window) is NOT supported. The Snap permissions for dotnet does not permit it to read hidden files (files or directories starting with a '.') which breaks core functionality of OpenTAP.

For Ubuntu 20.04 and up, we provide an installer similar to the windows installer.

  1. Download the installer (opens new window).
  2. Make the installer executable: chmod +x path-to-installer
  3. Start the installer.

The installer supports the --quiet flag which can be used to install OpenTAP in scripts, or in a terminal environemnt:

# Download the latest OpenTAP release
curl -Lo opentap.linux https://packages.opentap.io/4.0/Objects/www/OpenTAP?os=Linux
# Make it executable
chmod +x ./opentap.linux
# Run the installer
sudo ./opentap.linux --quiet
1
2
3
4
5
6

The installer is likely to work on other Linux distributions, but additional dependencies may be required on these platforms, such as dotnet 6 runtime.

# MacOS

There is no installer available on Mac. Instead, OpenTAP must be installed using the terminal:

# Download the latest OpenTAP release
curl -Lo opentap.zip 'https://packages.opentap.io/4.0/Objects/Packages/OpenTAP?os=MacOS&architecture=arm64'
# Extract it wherever you would like the installation to be
unzip ./opentap.zip -d opentap
# Make tap executable
chmod +x ./opentap/tap
1
2
3
4
5
6

OpenTAP requires dotnet 6 runtime. If you do not already have dotnet installed, get it from Microsoft (opens new window).

Verify the installation works by trying for example ./opentap/tap package list --installed.

# Docker

We also provide docker images for running OpenTAP. You can find them at hub.docker.com/r/opentapio/opentap (opens new window).

We maintain two images:

  1. a development image which includes all necessary tools to build OpenTAP projects (~2.5GB)
  2. a production image which includes only dependencies required to run OpenTAP (~330MB)

The development image is widely used for building and packaging plugins in highly reproducible environments, and we use it internally for continuous deployment. Have a look at the Demonstration plugin's gitlab CI file (opens new window) where we build, test, version, and publish the plugin directly in a continuous integration pipeline.

# Where to go next

Are you already an OpenTAP user, or want to try it out? Have a look at the User Guide.

Are you a developer and want to create plugins for OpenTAP? Have a look at the Developer Guide.

Overview →