--- title: "Tools" canonical: "https://docs.infoblox.com/space/NetMRIAdminG752/42140359/Tools" format: markdown --- You can use the following NetMRI software tools. Network tools (**Tools** icon **–>** **Network**): - *[API](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Documentation](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*, providing access to an external API guide for developers and displaying model details. Device tools (**Tools** icon **–>** **Device**): - *[Ping/Traceroute](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*, for determining whether a specific host can be reached across the network. - *[SNMP](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Walk](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*, for retrieving SNMP MIB variables. - *[SNMP](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Credential](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Test](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*, for finding a successful SNMP user name and password combination for a device. - *[Cisco](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Command](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Tool](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*, for issuing Cisco commands to a specified device. - *[CLI](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Credential](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Test](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*, for finding a successful CLI user name and password combination for a device. - *[Discovery](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[ ](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*[Diagnostics](https://infoblox-docs.atlassian.net/wiki/spaces/AdminG752DRAFT/pages/7995857)*, for diagnosing discovery and data problems for a device. # > Macro (anchor) > Macro (anchor) API Documentation> Macro (anchor) Instructions for using the NetMRI API are provided in the *NetMRI API Developer's Guide* available in the "Additional Documentation" section of the NetMRI online help. For the current version of the NetMRI Core API, go to **Tools –> Network –> API Documentation**. Select **API Data Structures**, scroll down to the **Models** section, and then select an item in the list to display model details and attributes. To access the online API documentation, enter **/api/docs** at the end of your NetMRI address. For example, *your_NetMRI_URI*/api/docs. # > Macro (anchor) > Macro (anchor) Ping/Traceroute Use the Ping tool (**Tools** **–>** **De**> Macro (anchor) **vice** **–>** **Ping/Traceroute**) to check communications to devices across the network. Ping can also be used as a speed test and to verify local network interface card operation. Use the Traceroute tool to determine the route taken by packets across the network. To perform a ping or traceroute test, do the following: 1. Open the **Hostname** **or** **IP** list and select the target device. --- **Note:** Type a few beginning characters of the host name or IP address to narrow the list. --- 2. Open the **Network**** View** list and choose the network view containing the IP. 3. In the **Packet ****Size** field, type the packet size. 4. Open the **Packet****Count** list and select the desired packet count. 5. Open the **Interval** list and select the desired interval in seconds. 6. To perform a ping test, click **Ping**. To perform a traceroute test, click **Traceroute**. 7. When the test is finished, "Processing Completed" appears above the log. 8. To export the data to a text file: click **Text** above the log. 9. To run the test again: click **Refresh**. 10. To change test parameters: click **Settings**. # > Macro (anchor) > Macro (anchor) > Macro (anchor) SNMP Walk Use the SNMP Walk tool (**Tools** **–>** **Device** **–>** **SNMP** **Walk**) to retrieve all SNMP MIB variables below a given root OID from a device on the network. The SNMP Walk tool may retrieve a large amount of SNMP data from the selected device depending on the specified root OID. For the list of supported encryption protocols, see [*SNMPv3 Credentials for Discovery and Management*](https://infoblox-docs.atlassian.net/wiki/spaces/NetMRIAdminG752/pages/42140640). You can also define the SNMP Walk settings in the Administrative Shell. For more information, see [*snmpwalk command*](https://infoblox-docs.atlassian.net/wiki/spaces/NetMRIAdminG752/pages/42369226/Administrative+Shell#AdministrativeShell-snmpwalkcommand). To perform an SNMP Walk, do the following: 1. Open the **Hostname**** or ****IP** list and select the target device from the dropdown menu. there may be many pages of values in the dropdown. You can also enter a new value. 2. Open the **Network** **View** list and choose the network view containing the specified device. 3. In the **Port** field, type the target port. 4. In the **Password** field, enter the SNMP community string associated with the device (the default string for read-only operations is usually "public"). You may also leave the **Password** field blank (if a community string was previously discovered for the device or a default is used, then that string is used to automatically perform the walk). 5. Select SNMP version 1, 2c or 3. 6. If you selected version 1 or 2c, specify the Root OID. 7. If you selected version 3, specify the following: - Authentication Password - Authentication Protocol - Privacy Password - Privacy Protocol - Root OID 8. In the **Root ****OID** field, type the starting point for the SNMP walk as a symbolic name or in dotted decimal notation. If a symbolic name is not recognized, try entering the dotted decimal notation instead. 9. Click **Start**. SNMP Walk displays progress through an **SNMP ****Polling** popup window. The bottom of the SNMP Polling text output reports the result of the polling cycle, displaying a **Polling** **Finished** **Normally** message on successful completion. To export the data, select the polling text, right-click and choose **Copy**. To run the test again, click **Restart**. # > Macro (anchor) > Macro (anchor) > Macro (anchor) SNMP Credential Test Use the SNMP Credential Test tool (**Tools** **–>** **Device** **–>** **SNMP** **Credential** **Test**) to determine a successful SNMP community string for a device. For the selected device, the tool tries all the community strings listed in the Settings icon **–>** **Setup** **–>** **Credentials** page using the same order as NetMRI's internal guessers. Testing stops when a successful string is found or all strings have been tried. --- **Note:** The SNMP Credentials Test can be run on any device, including those not known to NetMRI. --- To run an SNMP credentials test, do the following: 1. In the **Hostname**** or**** IP** field, enter a host name or IP address, or open the list and select a device. 2. Open the **Network ****View** list and choose the network view containing the specified device. 3. Click **OK**. 4. Then, do the following: - To stop the test: click **Cancel**. - To save the results or view them in a text editor: click the **Text** link. - To repeat the test on the save device: click **Refresh**. - To run the test on a different device: click **Settings**. # > Macro (anchor) > Macro (anchor) > Macro (anchor) Cisco Command Tool> Macro (anchor) Use the Cisco Command tool (**Tools** **–>** **Device** section **–>** **Cisco** **Command**) to issue Cisco commands to a specified device and view the results in the browser. To issue a Cisco command, do the following: 1. In the **Command** field, type the command you want to send. 2. Open the **Hostname**** or ****IP** list and select the target device. Type a few beginning characters of the host name or IP address to narrow the list. 3. Open the **Network** **View** list and choose the network view containing the specified Cisco device. 4. Specify a **Login** **Mode**:** ** **Automatic**: Attempt to retrieve a valid user name, password and enable password for the specified device. If this information cannot be found, an error is generated. **Manual**: Select the **Access** **Protocol** (**SSH** or **Telnet**), then enter the **Username**, **Password** and **Enable** **Password** in the corresponding fields. 5. Click **Start**. Results appear in an Executing Cisco Command popup window. 6. To run the test again: click **Restart** in the Executing Cisco Command popup window. 7. To run a new test: click **Close**. 8. To export the data: Click **Download** **Text**. # > Macro (anchor) > Macro (anchor) > Macro (anchor) CLI Credential Test Use the CLI Credential Test tool (**Tools** **–>** **Device** **–>** **CLI** **Credential** **Test**) to determine a successful CLI user name, password and enable password (if applicable) for a device. The CLI Credentials Test can be run only on devices known to NetMRI. For the selected device, the tool tries all the combinations listed in the Settings icon **–>** **Setup** **–>** **Credentials** page using the same order as NetMRI's internal guessers. Testing stops when a successful combination is found or all combinations have been exhausted. To run a CLI credentials test, do the following: 1. In the **Hostname** **or** **IP** field: Enter a host name or IP address, or open the list and select a device. 2. Open the **Network** **View** list and choose the network view containing the specified device. 3. Click **OK**. - To stop the test: click **Cancel**. - To save the results or view them in a text editor: click the **Text** link. - To repeat the test on the save device: click **Refresh**. - To run the test on a different device: click **Settings**. # > Macro (anchor) Discovery Diagnostics The Discovery Diagnostics tool (**Tools** **–>** **Device** **–>** **Discovery** **Diagnostics**) helps Infoblox Technical Support to diagnose discovery and data problems for a given device. --- **Note:** Output from this tool is typically used only by Infoblox Technical Support. The tool should only be run after you have been instructed to do so by Infoblox Technical Support. --- To run discovery diagnostics, do the following: 1. Open the **Hostname ****or ****IP** list and select the target device. 2. Open the **Network**** View** list and choose the network view containing the specified device. 3. If NetMRI doesn't know the community string for the device, enter it in the **Community**** String** field. If NetMRI knows the community string for the device, it is used for the test. If you enter a community string, it is used in addition to the one known to NetMRI. 4. Normally, leave the **Force**** Tests** option set to **Off**. (If the appliance can't run the tests to provide the data needed, this option can be set to **On** to force it to run all tests. Select the **On** option when directed by Infoblox Technical Support.) 5. Click **OK**. 6. When the test is finished, "Processing Completed" appears above the log. 7. Click **TEXT** to save the log. 8. Send the log to Infoblox Technical Support.