In this article, you will learn how to create an Application Scout that executes a user-defined shell command.
Configure Shell Execution for a New Scout
To configure Shell execution for a Scout:
1. In the Scoutbees dashboard, create a new scout by clicking Create Scout in the top-right menu.
2. Select the Applications tab. Under the Type drop-down menu, click Shell execution.
3. Select one or more Hives from which you want to run the shell command.
4. Provide a Name, the process name of the Command-line interpreter together with its Arguments and a scheduler.
5. Click Show additional parameters to configure the Working Directory where the command-line interpreter can be found. You can also define a Timeout in seconds to configure how much time the test should wait until the completion of the executed command and a range of Exit Codes that define the return values for your configured command.
The list of Exit Codes defines which exit codes will be considered as successful.
Save the changes by clicking Next: Alert Policy.
6. In the Alert Policy window, you can create an alert if a certain condition is met. As an example, we want to send an alert email if the Status of two consecutive tests is Failed. Click Next: Summary to see a summary report of your Scout configuration.
7. On the Summary page, verify the input data. Click Save Scout to create the new Scout.
View Test Results
Once you created a new Scout, await the results of the first tests. You can view the results by clicking View All Tests.
A list of all completed tests is displayed. Click a test to see the details of the shell execution.
In the Test Details window, a black result box is shown at the bottom. Besides the called executable and arguments, you can also see the returned Exit Code and standard output (STDOUT Body) of the test.