Configure the Scheduling Services
The Test Studio Scheduling services work together to ensure the seamless communication between the project and machines, which execute the tests. Their configuration is related and, thus, performed in a single config wizard.
The below article describes the configuration steps.
- Start the Test Studio Scheduling Config Wizard
- Configure the Test Studio Services
- Finish the Test Studio Services Configuration
Important
The Test Studio Services must be configured from a Windows Administrator account.
Start the Test Studio Scheduling Config Wizard
You can start the Scheduling config wizard in any of the following ways:
-
The wizard can be accessed through the Windows Start menu by typing Configure Test Studio Services.
-
The Configure Test Studio Services can be accessed through the opened in Test Studio project - click Configure button under the Project tab in the Scheduling section.
-
Once Test Studio services get installed (no matter in which edition of the product), the installation wizard suggests to start the Configure Test Studio Services automatically.
Configure the Test Studio Services
Important
If the machines have active firewall, ensure that the following ports are opened in both the inbound and outbound directions for all machines used in the configuration:
- Scheduling Service: 8009
- Storage Service: 8492
- Execution Machine(s): 55555
There are few tabs in the Scheduling configuration wizard, which provide the configuration details for each of the components of the Scheduling setup.
- Communication Tab
- MongoDB Tab
- Storage Tab
- Scheduling Tab
- Setup Automatic Emails for Scheduled Jobs
- Executive Dashboard Tab
- Non Admin Port Setup Tab
Communication Tab
The Communication Key is required by all Test Studio Scheduling components - services and clients, to establish the connection and communicate between each other. The Communication tab lets you manage the current key in use or generate and import a new one.
The Current Key section allows you to Copy to Clipboard the current key in use or Show its value (for the cases when copying is not an option).
The Replace Key section lets you Generate a new key. Once generated, the new value is populated in the text field and is ready to be imported. Hit the Import button to replace the current key with the new one.
Note
Importing a new key in the Scheduling Config wizard restarts the Scheduling service and Execution Server on that same machine to apply the new value.
If Test Studio application is also running on the same machine at the time of renewing the communication key, it is not automatically restarted. To apply the recent changes you need to restart the standalone Test Studio app manually.
See here step-by-step instructions on updating the communication key.
MongoDB Tab
The first tab is the MongoDB one and it contains the details required for the MongoDB database, which is used as a storage database in the Scheduling configuration.
The MongoDB data path and mongod.exe path fields are populated with the values for a default MongoDB installation, so you need to change these, only if the MongoDB installation was modified.
Hit the Apply button and confirm the 'MongoDB is running' status appears in the lower left corner of the wizard.
Note
The MongoDB tab will be grayed out (inactive) if you do not have MongoDB installed on the machine! This will get enabled when the correct Storage Service Location is set in the Scheduling tab.
Storage Tab
The Storage tab displays the connection details used from Test Studio Storage Service to access the MongoDB. The listed MongoDB connection string is the default connection string to be used for MongoDB database and is the only valid connection option for the Storage service.
Hit the Apply button and check the 'Telerik Storage Service is started' status appears in the lower left corner of the wizard.
Note
The Test Studio Storage Service and MongoDB require to be installed on the same machine.
Scheduling Tab
The Scheduling tab provides information about the location of the Test Studio Storage and Scheduling services. The default populated values point to the local machine - 'localhost'.
Hit the Apply button and check the 'Telerik Scheduling Service is running' status appears in the lower left corner of the wizard. Once started, the Scheduling service also shows details about the connected Storage service's status and database version in the Storage Service Location section.
Note
If the Test Studio services are hosted on different machines, you can enter the respective machine name or IP to configure these.
Automatic Email Notification for Scheduled Executions
Optionally, the Test Studio Scheduling service can be configured to use an Email (SMTP) server by specifying the email server connection details. By adding these settings you will be able to send an automatic email with the results of a scheduled test list.
The SMTP server settings are listed in the expandable section Configure Email (SMTP) server in the Scheduling tab. Mandatory fields are the 'SMTP server address' and the 'Port' to communicate with it, and the 'User Email', who sends the email. Depending on the SMTP server configuration, thr 'Password' field and 'Ssl' checkbox may not be explicitly required.
Once the necessary data is entered, hit the Apply button to reflect the changes to the Scheduling service and check if the status 'Telerik Scheduling Service is running' appears in the lower left corner of the wizard.
Note
If you are using an Outlook account with two-factor authentication enabled, you need to use an Application password created for the SMTP configuration. See the response in this Microsoft forum post for further details.
Executive Dashboard Tab
The Executive Dashboard tab provides information about the Storage Service Location from which the Dashboard takes results. The default populated value points to the local machine - 'localhost'. If the Test Studio services are hosted on different machines, you can enter the respective machine name or IP where the Storage service is running.
The Executive Dashboard section of the tab allows changing the port on which the locally hosted Dashboard page runs. From the hyperlink in this section you can load the Dashboard page in your default set browser.
Hit the Apply button and check the 'Telerik Scheduling Service is running' status appears in the lower left corner of the wizard.
Non Admin Port Setup Tab
The Non Admin Port Setup tab allows registering the ports, used from the Test Studio Scheduling configuration, to be available for users with no admin permissions in the 'URL Access Control List' for the preselected user or group. The default listed group 'NT Authority\Authenticated Users' represents all authenticated users. It can be changed to whatever is applicable for your organization.
Note
The default ports for the Test Studio services are reserved during installation for the 'NT Authority\Authenticated Users' user group.
Hit the Grant Access button to create reservation for the listed ports and an informational message appears to report the status of the action.
In the sample screenshot two of the ports are already reserved for the users in the listed group - in such case you see an Error: 183. Cannot create a file, when that file already exists. message to inform that the ports cannot be registered second time for the same user group.
Tip
The Ports in Use section displays the ports configured in the previous tabs of the Scheduling setup wizard. If you need to change any of these, get back to the respective tab and apply the necessary changes.
Finish the Test Studio Services Configuration
When all necessary settings are applied and all services are reported running, close the wizard window to finish the Scheduling Services setup.