Pre-requisites
to Test Scheduling
-
QEngine Server should be running in one of the machines (local
or remote machine).
-
If you need to execute Regression from a different host from
where the server is running, you should have downloaded and installed WebTestRegression.zip. This file can be downloaded from
the CommandLine Toolkit page by clicking the Download link. The CommandLine
Toolkit page will be displayed upon clicking the Regression Tool Kit
link from the right corner of the Regression tab in any testing type
screen. This will list the CommandLineWebTest.bat/.sh
files, setEnv.bat/.sh files
and the CommandLineConfigurator.html
file.
-
You should have downloaded and installed the QEngine Toolbar in
the configured browser. For details of downloading and installing the
toolbar, please refer to the topic Getting
Started.
Points to
Remember
-
Scheduling can be kicked-off in different client machines i.e.,
QEngine Server in one machine and the scheduled host in the remote
machine. The allowed combinations are windows-windows, windows-linux
and linux-linux. The only exception is scheduling cannot happen in
linux-windows combination i.e., if QEngine Server is in a linux machine
and the scheduled host is a windows machine.
-
If QEngine server and the scheduled host are in different
machines, i.e., if scheduled in a remote machine, then both the
machines should be in the same domain. Also, ensure that the system
date, time and the time zone are in sync in both the machines. Else
scheduling might not start at the configured date and time.
Scheduling
Operations
Adding a Schedule
A new test can be scheduled from any of the four testing screens
(i.e. Web Functional, Web Performance, Web Services Functional or Web
Services Performance). The steps to add a schedule will vary slightly
according to the testing screen. For example, if you are adding a
schedule from Web Functional screen, you will have a different set of
steps from that of other testing screens.
To add a schedule from web functional testing,
-
Navigate to the Web Functional
testing screen from the Suite Manager screen by clicking Continue with Web Functionality Testing
button.
-
Click the 'Regression' tab in the web functional test type
screen to move to the Regression screen.
-
Click the Add Schedule
button. This will display the Add Schedule page where you can add as
many schedules as you need.
-
Provide Schedule Name.
-
Select the Suite Name
from the list box. You can configure multiple suites for regression
execution. Also the order of the suite execution can be configured by
movind the suite to the listbox by pressing the arrow button. The
selected suites will be executed sequentially in the order specified.
In case
of selecting multiple suite you cannot choose Filter / Sequence as the
name might conflict with the different suite.
-
Select the sequence type for the executing test scripts. Choose
either 'Automatic' or 'Manual'. If you have chosen Automatic, select
the filter from the 'Available Filters' drop-down list box. If no
filter is available, you can configure filters by clicking the
'Configure Filters' link.
-
If you have chosen 'Manual' sequence type, select the configured
sequence from the 'Configure Sequence' list box. If no sequence has
been defined, click 'Configure Sequence' link to manually configure in
which sequence test scripts need to be executed.
-
Select the host port configuration from the Host Port Configuration to use
drop-down list box. Host port configuration is used to substitute
different host and port values dynamically during playback. If no
configuration is present, click the 'Configure Host Port Configuration'
link to add a new configuration.
-
Enter the email address that needs to be notified in the Email Id for mail notification field.
- Option to include / not include execution logs
while sending summary report after testing.
-
Select the host where the regression test needs to be run.
Select either Local Host or Remote Host.
-
If you chose Local Host, select the browser type with which
the regression is to scheduled from the 'Schedule at Browser' drop-down
list box. Currently, Internet Explorer, Firefox and Mozilla browsers
are supported. Specify the browser version in the 'Browser Version'
field.
-
If you chose Remote host, you need to configure the details of
the remote host where regression is to be scheduled. In the field
Command Line Toolkit Home Directory, enter the command line toolkit
home directory i.e., the directory where you have downloaded and
extracted the WebTestRegression.zip
file
-
Select the appropriate OS option - Windows or Linux i.e., the
OS of the machine where you have extracted the WebTestRegression.zip
file.
-
In the Host Description
field, enter any valid description for the host.
-
In the Host Name
field, enter the host name of the Regression client where regression
testing is scheduled.
-
Select the Protocol
to connect to the remote host. Telnet and SSH are the options
available. This is needed when the regression client OS is Linux.
-
Enter the user name and password details to authenticate and
log in to the remote host, in the User
Name and Password
fields respectively.
-
Select the Browser Name
from the list box (select from IE, FireFox and Mozilla) and specify the
Browser Version.
-
Recurrence Details:
Select the appropriate option to schedule the suite execution on a
hourly, daily, weekly, monthly basis or only once.
-
Hourly - To execute
test suites at a periodic time interval. Enter the starting time,
choose the starting day using the date time component and the interval
at which the next schedule should be called to execute the suite at
periodic intervals.
-
Daily - To execute the
test suite everyday. Enter the starting time and choose the starting
day using the date time component.
-
Weekly - To execute
the test suite on specific day(s) in a week. Enter the starting time
and choose the week days in which the test suite should be executed.
-
Monthly - To execute
the test suite on specific day every month(s). Enter the starting time,
select a day and select a month/months in which the test suite should
be executed. .
-
Once Only - To
execute the test suite only once at a specific point of time on a
specific day. Enter the time and date to execute the suite.
-
Finally, click the Save
button to save the new schedule details.
When adding a schedule from Regression tab of Web Performance
screen, the following additional fields are present:
-
Distributed Playback - Select this option to enable distributed
load testing. If you enable this option, you have to add the details of
the systems where QEngine agent is installed. Click the 'Add Agent
Details' button to configure the agent details. Refer this
link to know more.
-
Run against different server - Select this option to run the
test against a different server. Enter the host name and port of the
server against which the test needs to run.
Also, the fields 'Host port configuration to use' and 'Host details'
are not available in this screen.
When adding a schedule from the Regression tab of Web Services
Functional / Performance screen, certain options like 'Host port
configuration to use', 'host details', etc. are not available.
Adding a
Schedule from Suite Level
A regression test can also be scheduled from the suite level inside
all testing screens. Just select any suite from the Suite Manager
screen and move to any of the testing screens by selecting from either
Web Functional, Web Performance, Web Services Functional or Web
Services Performance option. The left side panel of the testing screen
displays the suite and its scripts load tests. Click the Schedule Suite for Regression link
on the right side of the screen. This will take you to the Regression
screen under Regression tab. From here on, follow the steps described
earlier to add a new schedule.
|
|
Only web functional testing can be scheduled in the remote
host. All other test types can be scheduled only in the local machine.
|
Editing a
Schedule
To edit a schedule from the Regression screen,
-
Click the Edit icon
from the required row in which the schedule to be edited exists. This
will display the Edit Schedule
page.
-
This page displays the configured schedule details. Edit the
required details and click the Save
button to save the changes.
Viewing
Scheduled Details
The test scheduler page displays the configured schedule details.
The details include:
-
Schedule Name - The unique name given for each regression test.
-
Test Type - The test type for the schedule (either Web
Functional, Web Performance, Web Services Functional or Web Services
Performance).
-
Host Name - The host or the machine in which the regression is
executed.
-
Last Run - The last execution date and time when the regression
was executed.
-
Next Run - The next schedule date and time when the regression
has to be executed.
-
Recurrence - The recurrence type such as hourly, weekly,
monthly, daily or once only.
-
Status - Whether the scheduled is currently enabled or disabled.
-
Edit - Option to edit the selected schedule.
-
Delete - Option to delete the selected schedule.
Enabling/Disabling
Schedule
If the selected Schedule is in the enabled state, then "green" icon
will be shown in the status column. You can click on it to disable it.
The disabled state will be shown with a "red" color icon.
