Execution

Execute arbitrary commands on target systems.

Command

Run any executable or bash-cmd on the DUT.

AttributeTypeRequiredDefaultDescription
cmdconstYescmdString that identifies the teststep that gets executed
namestringYesName to uniquely identify the teststep. This name will show up in reports, logs and the WebUI
transportTransportObjectYesDefines how the command is executed
optionsOptionsObjectNoAdditional command options
parametersCommandOptionsYesTeststep specific parameters

Command Options

AttributeTypeRequiredDefaultDescription
executablestringYesThe executable to run
args[]stringNoArguments to pass to the executable
working_dirstringNoThe working directory to run the executable in
report_onlybooleanNofalseIf set to true, the teststep will not validate the output against any expected values, thus never fail
expect[]CommandExpectOptionsNoExpectations to check against the output of the executable
variablestringNoThe name of the variable to store stdout

Command Expect Options

AttributeTypeRequiredDescription
regexstringYesRegular expression to match against the output of the executable

Command Example

cmd: cmd
name: Run echo test
transport: *transport
options:
  timeout: 20m
parameters:
  executable: "echo"
  args:
    - "Hello World!"
  expect:
    - regex: "Hello World!"
  variable: helloWorldVar