MTF toolchain installation for Windows

Prerequisites

Before installing the MTF (Modular Test Framework) toolchain on Windows, ensure that your system has the following prerequisites:

1. Valid License: Make sure you have obtained a valid license for the MTF toolchain. Please refer to the License request page for instructions on how to request and activate your license.

2. Visual Studio 2022 runtimes: Download and install the Visual Studio 2022 runtime from the following link: Download Visual Studio

3. Npcap or Winpcap: Learn more about Npcap and Winpcap.

4. Python 3.9 to 3.11 (64-bit): You can Download Python from the official website: Download Python . We recommend using Python version 3.9. During the installation process, make sure to select the option “install pip” as well.

5. Git: Install Git on your system.

Installing Npcap

To install Npcap, follow these steps:

1. You need to have access to our Technica Nexus Server

2. Download the executable file of the latest version of Npcap: Download , for example, npcap-1.79-oem.exe

3. Double-click the downloaded .exe file to launch the installation wizard.

4. During the installation process, ensure to select “WinPcap API-compatible mode”.

If you encounter any issues with Npcap, you still have the option to install Winpcap.

Installing Python

To install Python, follow these steps:

1. Visit the the official Python website at Download Python .

2. Find a stable Python 3 release, for example, Python 3.9.

3. Download the Windows installer (64-bit) executable file.

4. Double click the downloaded .exe file file to begin the installation process.

Step1:

Select the Add python.exe to PATH checkbox, which enables users to launch Python from the command line. Click Customize installation and continue.

Step2:

Make sure that “pip” will be installed during the installation process. It is needed to install MTF packages later

Step3:

Select the Add Python to environment variables checkbox. It is recommended to enable launching Python. Choose a simple Python installation directory e.g. C:\Python39 and make a note of it. This directory may be needed for future reference. Click Install to start the installation.

Step4:

You can verify whether the Python installation is successful through the command line: Enter ‘cmd’ in the Windows search bar Enter the following command in the command prompt: where python

Step5:

You can verify whether the Python version you have just installed is the default version through the command line. To do so: Enter cmd in the Windows search bar Enter the following command in the command prompt: python –version

Installing MTF

You can install the toolchain on Windows using either an installer or pip.

Using the installer

• To determine the appropriate version for download and to obtain a link to the executable, please create a ticket in the MTF support service desk:.

• Once you have obtained the link, download the executable file named MTF Tool Chain Installer X.XX.X.exe, where X.XX.X represents the version number.

• Finally double-click the .exe file to start the installation process.

Step1:

The MTF installer will attempt to locate the Python executable by searching the Windows Registry. If no entry is found in the registry, the user will need to provide the Python executable path manually (Typically C:\Python39).

Step2:

Add the MTF Core Libs location to the Local Machine “PATH” environment variable.

Step3:

Check the needed packages to install.

Step4:

Click Install to start the installation.

Step5:

You can verify whether the MTF installation is successful through the command line: Enter ‘cmd’ in the Windows search bar. Enter the following command in the command prompt: pip show mtf You can instead run: Your actual Python executable path -m pip show mtf for example: C:\Python39\python.exe -m pip show mtf

Step6:

You can verify whether your license is valid and active through the command line. Enter ‘cmd’ in the Windows search bar. Start Python, by entering the following command in the command prompt: python You can use python (or your actual Python executable path e.g. C:\Python39\python.exe) Once Python is running, import the ‘mtf’ module by entering the following command: import mtf If your license is not active, an error message box will be displayed, similar to the screenshot provided.

Using command line

• You need to have access to our Technica Nexus Server.

• To determine the appropriate MTF version to install, please create a ticket in the MTF support service desk:.

Open a command line and enter ‘cmd’ in the Windows search bar. Enter the following command in the command prompt: pip install mtf==1.14.0rc1+protected --extra-index-url https://nexus.technica-engineering.net/repository/pypi-public/simple 1.14.0rc1+protected is the MTF image version in this case.

You can verify whether the MTF installation is successful through the command line Enter ‘cmd’ in the Windows search bar. Enter the following command in the command prompt: pip show mtf

You can verify whether your license is valid and active through the command line. Enter ‘cmd’ in the Windows search bar. Start Python, by entering the following command in the command prompt: python You can use python (or your actual Python executable path e.g. C:\Python39\python.exe) Once Python is running, import the ‘mtf’ module by entering the following command: import mtf If your license is not active, an error message box will be displayed, similar to the provided screenshot.

Important

The command above will install every mtf package EXCEPT TechnicaKeywords. If you also need to install TechnicaKeywords, use the same command:

pip install technicakeywords==’compatible-version’ ‘Nexus path’

To determine the appropriate TechnicaKeywords version to install, please create a ticket in the MTF support service desk:.

The Nexus path can change depending on whether the user is installing a released version or a release candidate (sometimes needed for early testing of new features).

The exact path will always be provided by the support team.