Document toolboxDocument toolbox

Tools

You can use the following NetMRI software tools.

Network tools (Tools icon –> Network):

  • API Documentation, providing access to an external API guide for developers and displaying model details.

Device tools (Tools icon –> Device):

API Documentation

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.

Ping/Traceroute

Use the Ping tool (Tools –> De 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 PacketCount 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.

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" in Data Collection Techniques.

You can also define the SNMP Walk settings in the Administrative Shell. For more information, see snmpwalk command.

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.

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.

Cisco Command Tool

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.

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.

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.