Command Validation Tasks form for pattern-based discovery

  • Release version: Yokohama
  • Updated January 30, 2025
  • 2 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Command Validation Tasks form for pattern-based discovery

    The Command Validation Tasks form in ServiceNow Yokohama release enables you to create or modify tasks for testing pattern commands used in pattern-based discovery. This form helps verify if the commands execute correctly, addressing issues such as failed discovery commands. It is essential for ensuring reliable discovery operations and accurate configuration item (CI) identification.

    Show full answer Show less

    Key Fields and Their Purpose

    • Number: Automatically generated unique identifier for each validation task.
    • MID Server Selection Method: Choose how to select the MID Server for the test:
      • Specific MID Server: Manually select a MID Server.
      • Automatic MID Selection: Use a MID Server assigned to the target IP range or network, requiring prior MID Server IP range configuration.
      • Try All Eligible MID Servers: Test using any available MID Server for the IP range or network, also requiring prior configuration.
    • MID Server: Appears if "Specific MID Server" is selected, allowing selection of the particular MID Server.
    • Validate All Pattern Commands: Checkbox to validate all commands of a selected pattern simultaneously, simplifying bulk validation.
    • OS Class: Specifies the CI class representing the servers on which the validation runs.
    • Command Type: Defines the type of command based on server type, such as Shell Command, WMI Query, SNMP Query (Tabular/Scalar), SNMP Walk, or HTTP GET (with Basic Authentication only). This field is visible only if not validating all pattern commands.
    • IP Addresses: List of target IP addresses, ranges, or networks for testing commands. Supports comma-separated IPs, hyphenated ranges, and slash notation for networks. Using ranges or networks requires the ParseIPRanges script include installed.
    • Commands: Specific commands to test, typically those that previously failed during discovery. You can only select from available commands. This is visible only if not validating all pattern commands.
    • Pattern: The name of the pattern whose commands are being validated, visible only when not validating all commands at once.

    Practical Benefits for ServiceNow Customers

    • Enables targeted testing of discovery pattern commands to troubleshoot and resolve command execution issues.
    • Supports flexible MID Server selection methods to match your network and discovery architecture.
    • Simplifies validation of all commands associated with a pattern or allows granular testing of specific commands.
    • Facilitates command testing across multiple IP addresses, ranges, or networks with automated parsing support.
    • Improves reliability and accuracy of pattern-based discovery by verifying command credentials and execution before running full discovery.

    Command Validation Tasks form displays the fields that you must fill when you create or modify a task for testing a pattern command.

    For more information about testing pattern commands, see Validate commands used in pattern-based discovery.

    Field Description
    Number The task number is automatically created by the system.
    MID Server Selection Method Select the relevant method:
    • Specific MID Server - To define the MID Server for this test.
    • Automatic MID Selection - To use a MID Server that's assigned to the IP range or IP network that you want to use for the test. Select this method only if you have configured a MID Server with IP ranges or as a default MID Server for Discovery.
    • Try All Eligible MID Servers - To use any MID Server available for the the IP range or IP network that you want to use for the test. Select this method only if you have configured a MID Server with IP ranges or as a default MID Server for Discovery.
    MID Server The MID Server name.

    This field appears only if Specific MID Server is selected from MID Server Selection Method.
    Validate All Pattern Commands The check box for validating all commands used by a specific pattern simultaneously.
    OS Class The CI class that represents the servers on which you run this validation task.
    Command Type The command type that depends on the kind of the server:
    • Shell Command
    • WMI Query
    • SNMP Query (Tabular and Scalar)
    • SNMP Walk
    • HTTP GET (for Basic Authentication credentials, not Token)

    This field is available only when Validate Al Patterns Commands isn't selected.
    IP Addresses Any combination of IP v4 Addresses, IP Ranges, or IP networks. For example:
    • 10.196.39.12, 10.196.39.12 - Comma-separated IP addresses for a list of standalone addresses.
    • 1.1.1.1-1.1.1.100 - Hyphen-separated IP addresses for an IP range.
    • 1.1.1.1/28 - Slash notation for an IP network.
    Note:
    To use IP range or IP network, ensure you have installed the ParseIPRanges script include. For more information, refer to KB1123625: Command Validation Tool.
    Commands The commands for which you want to test credentials. Typically, it's a command that discovery process failed to execute. For example, /api/v1/pods?limit=50 or sudo dmidecode.

    You can select only commands from the list of available commands.

    This field is available only when Validate All Patterns Commands isn't selected.
    Pattern The name of the pattern for which you want to validate the commands.

    This field is available only when Validate All Patterns Commands isn't selected.