<h2>Command Validation Tool</h2><br/><div style="overflow-x:auto"><p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong><span style="font-size: 14.0pt;">Command Validation Tool</span></strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>What is the problem?</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">There is no tool available, which allows user to run a command on range of IP Address(es). In the absence of such tool, the validation of command on IP address(es)<span class="MsoCommentReference"><span style="font-size: 8.0pt;"> </span></span> against the credentials present in the instance do not happen. In case of discovery failure, where certain command did not execute as expected, majority of the times, we ask the customer to perform such validation by running the command from the virtual machine where mid server is installed.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>What are we doing?</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">We have implemented an application, which will allow the user to run a command on a range of IP addresses belonging a certain OS type. The user will also get to choose the mid server behaviour for this operation. The output of this operation will tell whether the execution was successful or not.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>How it is being resolved?</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">With the introduction of the command validation tool, now user do not have to go anywhere as most popular operation types/protocols will be supported in this tool. The</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Command validation tool supports operation types as:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Shell Command</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">WMI Query</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">SNMP Query (Tabular and Scalar)</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">SNMP Walk</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">HTTP GET (authenticated via Basic Authentication credentials)</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Following MID selection behaviour is also provided:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Specific MID Server</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Auto Select MID Server</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Try All Eligible MID Servers</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Note: 2<sup>nd</sup> and 3<sup>rd</sup> behaviour work when you have mid configured with proper IP ranges or application configured to include ‘Discovery’.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">The user can provide IPv4 addresses as input in the following manner:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Comma separated IP Addresses</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">IP Range</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">IP Network</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Comma separated IP Addresses, IP Range, and IP Network.</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Note: The IP range and IP network will only work, when you have ParseIPRanges script include imported to your instance. Script include (<span style="color: #34495e;"><a style="color: #34495e;" href="https://support.servicenow.com/sys_attachment.do?sys_id=1fd5f8d0dbc59550f766fd33399619b3"><span style="background-color: #ffffff;">sys_script_include_3389256b778201104cb984e35b5a99ad.xml</span></a></span>) is attached with the KB.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">The output of the Command Validation Task will be Command Validation Result which will give us the following:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Status: Success/Failure</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">State: pending/processing/done</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Result: Response from device/Reason for failure</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Steps to troubleshoot in case of failure (depending upon if we have error suggestion attached to the error code present in the response)</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Credentials used for command validation (Works for Shell, SNMP query and SNMP Walk in San Diego and Tokyo release)</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Requirement and Use Cases:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Troubleshooting Discovery Failures: In case of Discovery failure, if you see that there are failures in command execution either in pattern log or agent logs and the if reason for failure is not clean enough the tool can be used re-run the command on the failing IP and by choosing an appropriate mid. The Command Validation Tool can be used to detect the following:</li></ol> <ol style="list-style-type: lower-alpha; margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 72px; font-size: 12pt; font-family: Calibri, sans-serif;">Authentication issue</li><li style="margin: 0cm 0cm 0cm 72px; font-size: 12pt; font-family: Calibri, sans-serif;">Authorisation/Permission Issue</li><li style="margin: 0cm 0cm 0cm 72px; font-size: 12pt; font-family: Calibri, sans-serif;">No Valid credentials present</li><li style="margin: 0cm 0cm 0cm 72px; font-size: 12pt; font-family: Calibri, sans-serif;">IP not reachable from mid</li><li style="margin: 0cm 0cm 0cm 72px; font-size: 12pt; font-family: Calibri, sans-serif;">Command with wrong syntax</li></ol> <p style="margin: 0cm 0cm 0cm 36pt; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;" start="2"><li style="font-size: 12pt;"><span style="font-size: 12pt;">Bulk Execution of a Command: The tool can also be used to run a command of your choice on the range of IPs<span class="MsoCommentReference"> </span> to check for a certain configuration. To also be able to export the command validation task result records for a certain execution.</span></li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>Feature Flow:</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">The Command Validation Tool is going to be released via a new Scoped Application named ‘Pattern Designer Enhancements’. To avail this feature, we must install it from the list of plugins.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><img src="/sys_attachment.do?sys_id=cbd5f8d0dbc59550f766fd3339961987" width="460" height="259" /></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">After the Plugin is installed, once you refresh and if you search for ‘Command Validation Tool’ in the navigation menu, you will notice the relevant menu</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><img src="/sys_attachment.do?sys_id=43d5f8d0dbc59550f766fd3339961968" width="322" height="240" /></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Under Command Validation Tool, we notice 3 sub menus:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Create New: To create a new Command Validation Task Record</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Command Validation Tasks: To see the list of tasks</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Command Validation Task Results: To see the list of Task Results</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Creating a new Command Validation Task:</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Once we click on ‘Create New’ the below UI gets loaded:</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><img src="/sys_attachment.do?sys_id=53d5f8d0dbc59550f766fd333996198b" width="540" height="230" /></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Note: There are relevant field messages for ‘OS Class’, ‘IP Addresses’ and ‘Command’ field to guide the user, on what input is expected. The field message for ‘Command’ gives information about the syntax of different commands and a working example. The field message for IP Addresses and Command fields will change depending upon the Command Type field.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Following fields needs Input:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Mid Selection Method: Choose either of the 3 options which are: <ol style="list-style-type: lower-alpha; margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Specific mid server</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Auto Select mid server</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Try all eligible mid servers (will try executing command via all eligible MIDs)</li></ol> </li></ol> <p style="margin: 0cm 0cm 0cm 72pt; font-size: 12pt; font-family: Calibri, sans-serif;">Note: 2<sup>nd</sup> and 3<sup>rd</sup> behaviour work when you have mid configured with proper IP ranges or application configured to include Discovery.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;" start="2"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Mid Server: When you choose ‘Specific Mid Server’ as Mid Selection Method.</li></ol> <p style="margin: 0cm 0cm 0cm 36pt; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;" start="3"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">OS Class: Concerned OS class to which the IP addresses belongs. Example: Linux Server when all IPs you entered as input are Linux servers.</li></ol> <p style="margin: 0cm 0cm 0cm 36pt; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;" start="4"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Command Type: The type of command, you want to execute on the IP addresses. It can be Shell, WMI query, SNMP query, SNMP Walk or HTTP GET.</li></ol> <p style="margin: 0cm 0cm 0cm 36pt; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;" start="5"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">IP Addresses: The user can provide IP4 addresses as input in the following manner: <ol style="list-style-type: lower-alpha; margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;" start="4"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Comma separated IP Addresses</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">IP Range (1.1.1.1-1.1.1.100)</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">IP Network (1.1.1.1/28)</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Comma separated IP Addresses, IP Range, and IP Network.</li></ol> </li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> Note: The IP range and IP network will only work, when you have ‘ParseIPRanges’ script includes imported to your instance. Script include (<span style="color: #34495e;"><a style="color: #34495e;" href="https://support.servicenow.com/sys_attachment.do?sys_id=1fd5f8d0dbc59550f766fd33399619b3"><span style="background-color: #ffffff;">sys_script_include_3389256b778201104cb984e35b5a99ad.xml</span></a></span>) is attached with the KB.</p> <p style="margin: 0cm 0cm 0cm 36pt; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;" start="6"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Command: command belonging to the chosen command type, which can run on the chosen OS Server on the IP Addresses provided.</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <table class="MsoTableGrid" style="border-collapse: collapse; border: none;" border="1" cellspacing="0" cellpadding="0"><tbody><tr><td style="width: 127.35pt; border: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Command Type</p> </td><td style="width: 8.0cm; border: solid windowtext 1.0pt; border-left: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Command Syntax</p> </td><td style="width: 96.65pt; border: solid windowtext 1.0pt; border-left: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">IP Syntax</p> </td></tr><tr><td style="width: 127.35pt; border: solid windowtext 1.0pt; border-top: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Shell</p> </td><td style="width: 8.0cm; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">command</p> </td><td style="width: 96.65pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">No change</p> </td></tr><tr><td style="width: 127.35pt; border: solid windowtext 1.0pt; border-top: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">WMI Query</p> </td><td style="width: 8.0cm; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">["Namespace"][space]"WMI Query"</p> </td><td style="width: 96.65pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">No change</p> </td></tr><tr><td style="width: 127.35pt; border: solid windowtext 1.0pt; border-top: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">SNMP Scalar Query</p> </td><td style="width: 8.0cm; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">oid</p> </td><td style="width: 96.65pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">No change</p> </td></tr><tr><td style="width: 127.35pt; border: solid windowtext 1.0pt; border-top: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">SNMP Tabular Query</p> </td><td style="width: 8.0cm; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">oid[space][comma separated column number],</p> </td><td style="width: 96.65pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">No change</p> </td></tr><tr><td style="width: 127.35pt; border: solid windowtext 1.0pt; border-top: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">SNMP Walk</p> </td><td style="width: 8.0cm; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">oid</p> </td><td style="width: 96.65pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">No change</p> </td></tr><tr><td style="width: 127.35pt; border: solid windowtext 1.0pt; border-top: none; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">HTTP GET</p> </td><td style="width: 8.0cm; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">httpEndpoint,</p> </td><td style="width: 96.65pt; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; padding: 0cm 5.4pt 0cm 5.4pt;" valign="top"> <p style="text-align: center; margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">ip:port</p> </td></tr></tbody></table> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Note: The field message for ‘Command’ on the UI also gives information about the syntax of different commands and a working example for each.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Once done, you can save the record or click on ‘Run Command Validation’ button to begin the task.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">The task records have:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Status field: which shows the status if it is in progress or completed</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Progress field: which will show the progress as percentage complete.</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>Batching:</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Once the command validation task is active, the IP addresses will be picked up by the mid in batches. By default, the batch count is 10.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">The following system properties is introduced, where batch count can be customised:</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> “command.validation.probe.batch.count”</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">State of the Command Validation Task Result Records:</p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Pending: Yet to be picked by scheduler and dispatched to mid server</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Processing: Scheduler has picked the record and dispatched to mid for execution</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Done: The execution of command is completed, and result is created.</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>Troubleshooting Steps when the Command validation Task Result is a failure:</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Once we open the record of the any failed Command validation Task Result, you will see an UI action or a link by the name ‘Open Suggestions to troubleshoot failure’. Once you click on this link, you will see a dialog box, with suggestions on how to troubleshoot this failure. This suggestion is coming from Error Suggestions table. If the error code present in the command validation task result record is linked with any error suggestion OOB, then we will see a proper suggestion. Check the screenshot below:</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><img src="/sys_attachment.do?sys_id=cbd5f8d0dbc59550f766fd3339961964" width="452" height="171" /></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>ACL and Role:</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Both the new tables ‘Command Validation Task’ and ‘Command Validation Task Results’ have been configured with ACL, where create, update, read and delete operation privilege is given to role ‘discovery_admin’.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>Scheduled Job:</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">A scheduled job is also introduced, whose responsibility is to pick Command Validation Task Results record in batches (which is by default 10) in a regular interval (by default the schedular is configured to run every 15 seconds) and send their content to ECC queue via probe. User can customise the batch count and frequency as per their environment and instance and mid configuration.</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Name of scheduled Job: ‘Schedule Command Validation Probe launch’</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><img src="/sys_attachment.do?sys_id=c3d5f8d0dbc59550f766fd3339961960" width="444" height="236" /></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong>Working example, where we run ‘sudo dmidecode’ on a list of IP addresses belong to Linux servers</strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><img src="/sys_attachment.do?sys_id=47d5f8d0dbc59550f766fd3339961984" width="452" height="266" /></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong><u>Things to Note:</u></strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <ol style="margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">IP ranges, IP Network as input will only work when you have imported ‘ParseIPRanges’ script include present in KB attachments.</li><li style="font-size: 12pt;"><span style="font-size: 12pt;">‘Credential Used’ attribute in Command Validation Task Results on works for command type: Shell, SNMP query and SNMP walk. This works in San Diego and Tokyo. We might observe<span class="MsoCommentReference"> </span> the feature working for SNMP query and SNMP walk in Rome.</span></li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Mid Selection Method: Auto Select Mid and Try All Eligible Mid servers, will only work when: <ol style="list-style-type: lower-alpha; margin-bottom: 0cm; margin-top: 0px; list-style-position: inside;"><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">You mid servers are configured with desirable IP ranges or</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">You mid servers have ‘application’ configured to include ‘Discovery’.</li></ol> </li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Choose Command Type in such a way that it can be run on the chosen OS Server. The chosen IP Addresses should belong to the chosen OS Type. For example: WMI query cannot be run Linux OS.</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Choose MID such that the chosen command type can be run via it. For example: WMI query cannot be run using Linux mid.</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">HTTP Get command type, will only work, when the credentials of API call is present as Basic Auth credentials. Token based credentials are not supported for this operation. This is also conveyed via field messages.</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">Kindly use the Command Validation Tool carefully, as it enables us to run any kind of command on the range of IP Addresses.</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">The application is supported on Domain Separated Environment.</li><li style="margin: 0cm 0cm 0cm 0px; font-size: 12pt; font-family: Calibri, sans-serif;">There are no APIs exposed to trigger Command Validation Task.</li></ol> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"><strong><u>Release Information</u></strong></p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;"> </p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Release: August 2022 Store</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Application version : 2.0.0</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Previous version: None</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Family version Supported: Quebec P-10, Rome P-8, San Diego P-5, Tokyo. (Onwards Supported)</p> <p style="margin: 0cm; font-size: 12pt; font-family: Calibri, sans-serif;">Note: This is the first release of this scoped application.</p> <div> <div> <div id="_com_6" class="msocomtxt"> <p style="margin: 0cm; font-size: 10pt; font-family: Calibri, sans-serif;"> </p> </div> </div> </div></div>