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
The Test Studio Services must be configured from a Windows Administrator account.
You can start the Scheduling config wizard in any of the following ways:
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.
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.
There are few tabs in the Scheduling configuration wizard, which provide the configuration details for each of the components of the Scheduling setup.
- MongoDB Tab
- Storage Tab
- Scheduling Tab
- Setup Automatic Emails for Scheduled Jobs
- Executive Dashboard Tab
- Non Admin Port Setup 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.
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.
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.
The Test Studio Storage Service and MongoDB require to be installed on the same machine.
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.
If the Test Studio services are hosted on different machines, you can enter the respective machine name or IP to configure these.
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.
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.
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.
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.
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.
When all necessary settings are applied and all services are reported running, close the wizard window to finish the Scheduling Services setup.
If the machines have active firewall, ensure that the following ports are opened in both the inbound and outbound directions:
- Scheduling Service: 8009
- Storage Service: 8492
- Execution Machine(s): 55555