tdk-cmd-util

tdk-cmd-util is a command line utility to execute TDK scripts. The user does not have to setup the TDK Test manager to use the commandline utility.

Setup

There are different versions of utility available. User can select one of the ways depending on the environment.

• Using pyenv : This can be used when the user have an ubuntu system with no TDK test manager setup and the user dont want to install docker in the system. The utility will create a virtual python environment in the system and run the tools with that environment so that the system will not have any impacts on running the tool.
• Using docker : If the user have an ubuntu system with no TDK test manager setup, and user is willing to install docker in the system, this is the best option. On installing the tool, it will create a docker instance and the user will be able to run the tool from inside the docker container.
• Using existing TDK TM setup : If the user already have a TDK test manager setup in the system, the user can utilize the same docker container to run the command line utility just by installing the tool inside the container.

Pre-requisites

• The system must have python3 installed preferrably python3.8
• If the system has python3.6 run export PYTHONIOENCODING=utf-8 before running the tool
• Python3.12 may cause few issues due to modified libraries in python
• The system must have access to the device to be tested
• Docker must be installed in the system to use docker based utility

How to setup and run

pyenv

1. Create a folder in the system : mkdir TDK_Execution
2. Copy the given tdk-cmd-util-pyenv.deb to the folder
3. Install the tool in the system : sudo apt-get install ./tdk-cmd-util-pyenv.deb
4. Keep the updated device specific configuration file to the folder TDK_Execution to execute Thunder enabled scripts.
5. Start the execution : sudo tdk-cmd-util

Note : To upgrade the tool to the latest version, just download the latest version of .deb file and run the install command.

Docker

1. Copy the given tdk-cmd-util-docker.deb to the system
2. Install the tool : sudo apt-get install ./tdk-cmd-util-docker.deb
3. Enter to the dokcer container : tdk-cmd-container-shell
4. Create a folder in the docker container : mkdir TDK_Execution
5. Keep the updated device specific configuration file to the folder TDK_Execution to execute Thunder enabled scripts.
6. Start the execution : tdk-cmd-util

Note: To upgrade the tool to the latest version, just download the latest version of .deb file and run the install command.

Existing TDK TM

1. Create a folder inside the TDK docker container : mkdir TDK_Execution
2. Copy the given tdk-cmd-util-with-tm.deb in the folder
3. Install the tool in the container : apt-get install ./tdk-cmd-util-with-tm.deb
4. Start the execution : tdk-cmd-util

Note : To upgrade the tool to the latest version, just download the latest version of .deb file and run the install command.

Version selection

The user can get the tool with respect to the TDK TM version. If the user wants to install the tool to execute the TDK scripts from M135 version, choose the debian package with version 1.3.5. Similary M136 will be 1.3.6.

Pending

1. Few installations like google-chrome, pillow etc are yet to include
2. Need to execute all suites and verify to identify any missing changes
3. REST API logging mechanism for MVS scripts
4. Need to include ALL option to select full scripts in the suite