Document toolboxDocument toolbox

Adding and Testing CLI Credentials for a Device

To establish CLI device credentials at the device level, complete the following:

  1. On the Network Explorer page, do one of the following:
    • Click Inventory > Devices and then click a device IP.
    • Click Discovery and then click a device IP. 
  2. In the Device Viewer, click Settings and Status > CLI Credentials to open the page for creating CLI login credentials.
  3. Click Edit.
  4. For CLI Credentials, you may provide up to three different login tuples: for SSH, Telnet, and for the HTTP protocol. Enter the username and password for any or all three as required for the selected device. For SSH and Telnet, you also provide a port number. You can use the default or custom ports.
  5. Provide the Enable Password.
  6. To test the new credential, click Test. You can also click Show Password to verify that you have entered the correct values.

For CLI credentials, NetMRI attempts to log in to the device using both telnet and SSH with the credentials configured for each, including empty credentials. The test passes if the login is successful. The HTTP protocol is not used during the test.

A test example is shown below, indicating that no SSH credential is provided but a successful telnet login tuple was provided:

Test Starting

+++ SSH: Trying [] [] [] ........................... FAILED

+++ Telnet: Trying [qagroup] [qalogin] [] .......... OK

+++ Telnet: Credentials Successful [qagroup] [qalogin] []

+++ Discovered working credential for device after testing 1 credentials

Test Completed

7. Click Save.

The lower panel is a history that lists all credentials attempted during the last credential guessing attempt for the given device. This data resets each time credentials are guessed for a device. The table indicates the time of each guess and the result of that attempt. If a device is manually configured with a credential, NetMRI updates the history once it attempts to use that credential for data collection.

Retrieving Configs

A Get Configs button appears on the CLI Credentials page of the Device Viewer to fetch the current configuration files from the device. After clicking Get Configs, the following notification appears in the Device Viewer: "A request to retrieve the configs has been dispatched. If a change from the previous retrieval is detected, the new configs will appear shortly. Otherwise, the Last Collected timestamps of the previous retrieval are updated to reflect the current time, indicating that no change was detected."

This feature can be verified on the Configuration Management > Archive page by clicking the table row for the device. This brings up the Config Explorer for the selected device. A Get Config button is also provided in this location.