How to Launch Tests from a Remote Computer

How to Launch Tests on a Remote Computer from Command Line

Objectives

In this tutorial you'll learn HOW TO:
► Run your tests from command line
► Launch tests on a remote computer
► Execute tests one after another in sequence
► Put a test job to one of prioritized job queues
► Pass test parameters to each test job
► Schedule a job to start at a specific date/time
► Launch ETS tests from third party tools

All Tutorials

Technical Background

Generated Script

As you click on the "Generate and Run" button, ETS generates a fully autonomous script and runs it.
The “generated script” contains initialization procedures, calls to your test steps, flow control logic and garbage collection actions at the end.

Another way to do it to click on “Generate” button.
The “generated script” is actually your test case ready for execution as a job by ETS.
By default, ETS saves the “generated script” named MyTestCase.esl in the folder C:\ETS_Workspaces\MyProject\TestCases.

Job Queues

ETS is periodically polling its local job queues for jobs posted for execution.
Three prioritized queues are supported: High, Medium and Low.

Open the “Local Jobs Manager” from the ETS main menu to view and manage job queues .

Using the Local Jobs Manager you can see posted jobs, suspend and release queues and re-order jobs in queue

IAC Address

The IAC address stands for Inter-Application Communication address.
It serves Coronys Framework Tools for the control messages exchange.
The IAC address comprises the test station IP followed by the UDP port 30000 separated by "@".
Vew the ETS IAC address in "About" text box, accessed from Help->About.

How to ...

CmdToJob Utility

You can submit a job from command line using the CmdToJob.exe utility.
The CmdToJob.exe utility is located in the "c:\ets" folder after Coronys Framework instalation.
The full specification CmdToJob.pdf is located in C:\ETS\manuals.
In this tutorial we’ll explain just a part of the utillity options.

To submit job use the CmdToJob command line utility:

CmdToJob.exe –JSFN Job_Script_File_Name –TIAC Test_Station [–JN Job_Name –JTIME Job_Executon_Time –P Job_Parameters –JP 1 | 2 | 3]

Where:
– Square brackets "[ ]" mean optional arguments.
– The “|” means OR, for example, “1 | 2 | 3” means you can use either 1 or 2 or 3.

Below is the description of the command-line arguments (Strings should be quoted):

JSFN	Job Script File Name with full path
TIAC	Test Station IAC (Inter-Aplication Communication) address
JN	Job name
JTIME	Run the job after the specified time in format: YYYY,MM,DD,HH,MM,SS. The current time is taken if omitted.
P	Job parameters ( var=val1,...).
JP	Job priority (0=Low, 1=Medium, 2=High)

Examples

Submit test job with test case script name MyTest.esl to the station with IP 192.168.1.1:

C:\ets\cmdtojob.exe –JSFN “C:\ETS_Workspaces\MyProject\TestCases\MyTestCase.esl” –TIAC 192.168.1.1@30000

Submit test job with test case script name MyTest.esl with parameters:

C:\ets\cmdtojob.exe –JSFN “C:\ETS_Workspaces\MyProject\TestCases\MyTestCase.esl” –TIAC 196.168.1.1@30000
-P "Param1=`196.168.1.1`,Param2=512"

Note: two sets of quotes are required for our example. IP address is a string which has to be quoted and entire list of parameters should be quoted as well.

Submit test job with test case script name MyTest.esl to the station with IP 192.168.1.1 than will start not earlier than at 14:00 on 2016, January 31:

C:\ets\cmdtojob.exe –JSFN “C:\ETS_Workspaces\MyProject\TestCases\MyTestCase.esl” –TIAC 192.168.1.1@30000
-JTIME=2016,01,31,14,00,00