--- title: "Tools" canonical: "https://docs.infoblox.com/space/NMRI743AG/27983908/Tools" format: markdown --- NetMRI software tools are organized into two categories. Network tools (**Tools** icon **–>** **Network**): - *[API](#Tools-bookmark789)*[ ](#Tools-bookmark789)*[Documentation](#Tools-bookmark789)*, providing access to an external API guide for developers and displaying model details. Device tools (**Tools** icon **–>** **Device**): - *[Ping/Traceroute](#Tools-bookmark791)*, for determining whether a specific host can be reached across the network. - *[SNMP](#Tools-bookmark793)*[ ](#Tools-bookmark793)*[Walk](#Tools-bookmark793)*, for retrieving SNMP MIB variables. - *[SNMP](#Tools-bookmark796)*[ ](#Tools-bookmark796)*[Credential](#Tools-bookmark796)*[ ](#Tools-bookmark796)*[Test](#Tools-bookmark796)*, for finding a successful SNMP user name and password combination for a device. - *[Cisco](#Tools-bookmark798)*[ ](#Tools-bookmark798)*[Command](#Tools-bookmark798)*[ ](#Tools-bookmark798)*[Tool](#Tools-bookmark798)*, for issuing Cisco commands to a specified device. - *[CLI](#Tools-bookmark801)*[ ](#Tools-bookmark801)*[Credential](#Tools-bookmark801)*[ ](#Tools-bookmark801)*[Test](#Tools-bookmark801)*, for finding a successful CLI user name and password combination for a device. - *[Discovery](#Tools-bookmark803)*[ ](#Tools-bookmark803)*[Diagnostics](#Tools-bookmark803)*, for diagnosing discovery and data problems for a device. # > Macro (anchor) > Macro (anchor) API Documentation> Macro (anchor) Instructions for using the API are provided in a separate document, "NetMRI API Developer's Guide," available in the "Additional Information" section of the NetMRI online help. For the NetMRI Core API v3.3, the **Tools –> Network –> API Documentation** application page displays information about each model. Select **API Data Structures**, scroll down to the **Models** section, and then select an item in the list to display model details and attributes. You can also access the API documentation by clicking **/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> Macro (anchor) 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. To perform an SNMP Walk test, 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. --- **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 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. In the **Root****OID** field, type the starting point for the SNMP walk. --- **Note:** Specify the Root OID as a symbolic name or in dotted decimal notation. If a symbolic name isn't recognized, try entering the dotted decimal notation instead. --- 7. Click **Start**. SNMP Walk displays progress through an **SNMP****Polling** popup window. To export the data: select the polling text, right-click and choose **Copy**. To run the test again: click **Restart**. 8. The bottom of the SNMP Polling text output reports the result of the polling cycle, displaying a **Polling** **Finished** **Normally** message on successful completion. # > 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) > Macro (anchor) > Macro (anchor) Discovery Diagnostics The Discovery Diagnostics tool (**Tools** **–>**> Macro (anchor) **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 for 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.