Visore is an Italian word, which translates to Viewer. It allows users to a mechanism to browse and navigate the management objects (MOs) in the system's management information tree (MIT). This enables users to view the structure of the Open NX-OS DME data-model that backs the NX-API REST interface. Visore enables users to gather information about the data associated with a specific object or a group of objects, typically for the purpose of troubleshooting and event analysis. Visore is also a very useful educational tool to understand how Open NX-OS stores data within with the data model. Visore supports querying by Distinguished Name (DN) or Class.

Note: Visore is not capable of performing configuration operations.

To access Visore, follow these steps:

• Enable NX-API in the configuration of the switch with feature nxapi
• Open a web browser and connect to the URL https:///visore.html

The authentication challenge will display where the user will need to enter credentials.

Cisco NX-API CLI Sandbox Login Screen

After authenticating, the Visore object store browser is displayed.

Browsing Cisco NX-API REST Object Store with Visore

Here is a sample BGP configuration, which we will then show in the MIT using Visore:

  router bgp 65501  
    router-id 10.10.10.12  
    timers bgp 60 180  
    timers prefix-peer-timeout 30  
    timers prefix-peer-wait 90  
    graceful-restart  
    graceful-restart restart-time 120  
    graceful-restart stalepath-time 300  
    reconnect-interval 60  
    fast-external-fallover  
    enforce-first-as  
    event-history periodic  
    event-history events  
    event-history cli  
    address-family ipv4 unicast  
      network 10.10.0.0/16  
      network 168.10.10.0/24  
      network 192.0.0.0/8  
      maximum-paths 1  
      maximum-paths ibgp 1  
      nexthop trigger-delay critical 3000 non-critical 10000  
      client-to-client reflection  
      distance 20 200 220  
      dampen-igp-metric 600  
    neighbor 10.10.10.11  
      remote-as 65000  
      dynamic-capability  
      timers 60 180  
      address-family ipv4 unicast  
        next-hop-third-party  

Visore can be used to examine how the configuration is represented in the data model. For example, we browse to the top-level of the BGP object at sys/bgp:

Browsing Cisco NX-API REST BGP Object Store with Visore

By navigating deeper into the BGP data model (select the right-arrow next to sys/bgp), we can see how BGP data is modeled within the MIT.

As we continue to navigate the browser, we can observe object hierarchy and dependency.

Navigating Deeper into Cisco NX-API REST Object Store with Visore