Searching for Topology Graphs

Searching for a Topology Graph

To search for a topology graph:

On the ATA home page, click the icon on the top-left corner.

This opens the Topology Graphs search pane with a list of topology graphs that you have saved (if any). These topology graph records show the corresponding names, descriptions, and the number of nodes. See "Customizing a Topology Graph Search" for more information.
(Optional) Type the name or description of a topology graph in the Search field.

A list of related search results appears.
Choose a topology graph and click on it or select Render Map in the ellipsis options.
(Optional) Select Edit or Discard to edit or discard the topology graph search.
(Optional) Click Create New to customize a new topology graph search.

A Create New pane appears. See "Customizing a Topology Graph Search" for more information.

Customizing a Topology Graph Search

You can customize your topology graph search in the Create New search pane. You can use this customized topology graph search for quickly accessing and monitoring the topology graph without selecting the attributes every time.

To customize your topology graph search:

Enter a name and a description for the topology graph.

Note:
Name is mandatory for Save & Search.
In the Attributes side pane, click the '=' icon of an entity to drag and drop the corresponding attributes to the topology graph. See "Selecting Attributes while Customizing a Topology Graph Search" for more information on the list of supported entities and the corresponding attributes.
You can add attributes using the following options:
- To add a specific attribute within an entity, expand the entity and drag and drop the specific attribute to the list.
- To add a specific attribute to the list, click the '+ ' icon of the required attribute. You can add all attributes within an entity to the list.
Note:
- If you add a specific attribute to the list, the corresponding entity gets added to the list.
- You can add multiple attributes associated with the entity that is already added to the list.
- If you have added an attribute of an entity, you cannot add another attribute from another entity.
(Optional) To add an attribute from another entity, remove the existing attribute or attributes from the list and then add the required attribute from another entity.
To remove an attribute or entity, click the Remove icon from the list of added attributes.

Note:
Removing an entity removes all corresponding attributes from the list.
After you add all attributes, click Save & Search.

The customized topology graph search is saved and the corresponding topology graph appears. You can use this customized search from the list of saved searches for quickly accessing it.
(Optional) Click Search to open the topology graph without saving the search.

The topology graph that contains all the selected attributes appears.
(Optional) Click Cancel to cancel the search.

The following image shows the Create New search pane.

Figure 4-1 Customizing Network Search

Description of img_customizingnetworksearch_ata.png follows

Description of the illustration img_customizingnetworksearch_ata.png

Selecting Attributes while Customizing a Topology Graph Search

You can select an entity and its corresponding attributes to customize a topology graph search. Select or enter the corresponding values of these attributes to customize your search. The search returns results with a topology graph that contains only the selected entity types.

You can add only one entity from the list of entities. Adding an entity adds all the corresponding attributes to the search.

The list of supported entities are:

Connectivity
Device
Location
Network
Service

Each entity has a list of attributes. You can select all or a few of these attributes. By selecting a set of attributes, you can customize your topology graph to display only the corresponding information.

Except for Service, all other entities have both generic and entity-specific attributes. The list of these specific attributes varies with the entity that you select. The Service entity has only two attributes, Name and Version.

Table 4-1 lists the generic attributes.

Table 4-1 Generic Attributes

Attribute	Description
Identifier	The identifier of the topology component. You can enter an identifier or select from the list of identifiers.
Name	The name of the topology component. You can enter a name or select from the list of names.
Technology	Enter the technology to search for the topology components operating under the technology.
Rate Code	Enter the rate code to view the topology components that are associated with it.
Hops	Enter the number of hops or select from the list, to search for the topology components within that number.
Vendor	Enter the name of the vendor to search for all the topology components of the vendor.
Category	Enter a category for Network or a device category for Connectivity, Device, and Location. The values are defined by the customer. See "Dynamic Attribute Mapping between UIM and ATA" in Unified Inventor and Topology Deployment Guide for more information.

Table 4-2 lists the entity-specific attributes.

Table 4-2 Entity-Specific Attributes

Attribute	Description
Domain	Enter the network address domain. This attribute is specific to Connectivity and Device.
Specification	Enter the specification that is used to create the entity. This attribute is specific to Connectivity and Device.
Node Type	Enter the node type.
Distance	Enter the distance to search for all the topology components available within the given distance from the location or device. Select the distance unit from the list beside this field. You can select Meter, Kilometer, or Mile as distance unit. This attribute is specific to Location and Device.
Device Specification	Enter the device specification that is used to create the entity. This attribute is specific to Location and Network.
Area	Enter the location area to search for all topology components available within that area. This attribute is specific to Location.
Circle	Enter the circle to search for all topology components within the circle. This attribute is specific to Location.
SubCategory	Enter the subcategory to search for all subnetworks with the specified types. See "Viewing Networks and Subnetworks" for more information. This attribute is specific to Network.
Topology Type	Enter the topology type. This attribute is specific to Network.
Sub Type	Enter the topology sub type. This attribute is specific to Network.

Note:

Category, Domain, Node Type, Area, Circle, SubCategory, Topology Type, Sub Type are defined by the customer through Topology Mappings.

Viewing Networks and Subnetworks

You can view multiple layers of a network by navigating up or down the network hierarchy.

An example of a network hierarchy is:

National > Regional > CircleCore > Aggregate > Pre-Aggregate > Access

You can have either of the following types of networks:

Multiple layers within a single network that follows the network hierarchy. For example: A Regional network has few nodes and one Aggregate subnetwork. You can see the subnetworks within the Aggregate subnetwork by clicking on it.
Different types of subnetworks within a single parent network. For example: You can have a Regional network that in turn has its own nodes along with Aggregate and the corresponding Access networks. The nodes within the Access network can connect to the nodes within the Regional network through the Aggregate network. Figure 4-2 shows a network having different types of subnetworks.
All the devices and connectivities exist within a single network. Oracle does not recommend this approach.

Note:
Setting a device category attribute is supported on device or connectivity search.

To open any specific subnetwork, you need to enter the corresponding parent network name attribute in Name and the subnetwork type attribute in Category in the Create New Topology Graph search page.

The subnetwork appears with a network icon. The number of internetworking nodes within the subnetwork appear as a number on the icon. The internetwork nodes of a subnetwork are the nodes that have a connection (edge) with the nodes in the parent network.

You can peform the following actions on subnetworks:

Right-click on the subnetwork and select Isolate to view the nodes and edges associated with the subnetwork. This option isolates the subnetwork alone into a new view and does not show the nodes and edges of the parent network.
Right-click on the subnetwork and select Expand Node to view the expanded subnetwork with all nodes and edges of the subnetwork that are connected to the nodes and edges of the parent network.

Figure 4-2 Subnetworks within a Single Network

Description of "Figure 4-2 Subnetworks within a Single Network"

Searching within a Topology Graph

You can search of the required network elements within a selected topology graph. You use the Search icon at right corner of your topology canvas.

Click on the Search icon opens a search panel on the left. You can select the following options while searching:

Select Search and Filter Topology to search, filter, and view the topology based on a search criteria. See "Using Search and Filter Topology" for more information.
Select Ring Search to search the naturally occurring rings in the topology graph displayed on the canvas. See "Using Ring Search" for more information.

Using Search and Filter Topology

The Search and Filter Topology panel has a search bar with filter options under it. Each filter option represents one filter type, such as Location, Network Type, and so on. Each option has a value chosen by default. To see the list of filters supported, see "Searching within a Topology Graph". Below the search bar is a list of all the nodes and edges in a topology graph. The nodes are grouped into categories by Location, while the edges are grouped separately.

Use Search and Filter Topology as follows:

Search for a network element or multiple network elements within the topology graph.

Note:

You can use a global search by entering a required value to search for the network element.

The search is case sensitive.
View all nodes and edges in a tree view.
Select the required nodes or edges from the tree view to the selected elements highlighted within the topology graph and an overview panel appears on the right-side that shows the details of the selected node or edge.
Use the filter chip options to filter and search for the required network elements. You get the filter chip options based on the network elements you select.
Use the filter chip options as follows:
1. Select an option to view the corresponding list of network elements.
  
  Note:
  You may select any number of filter chip options.
2. Click on the selected option within the Search bar to view a list of values you can select.
3. Select the required value to view the list of network elements for the selected value.
  
  Note:
  
  The highlighted nodes appear along with their associated edges in the canvas. When filters are removed, the entire topology appears.
4. Select Node or Edge to toggle between the list of nodes or edges.
  
  Note:
  
  For edge search, the terminal nodes of the matching edges appear on the canvas.
5. Click on a filter chip to change the value of the corresponding filter chip.
6. Select a filter chip to view only the corresponding part of the topology graph in the canvas.
7. Close the filter option to deselect the filter.

Using Ring Search

A network ring is a closed loop of nodes and edges that starts from a node, connects other nodes and ends at the starting node.

The Ring Search allows the user to find all the naturally occurring rings in a searched network displayed on the canvas. Using the Ring Search, you can search for all rings based on nodes and edges. The Ring Search can be customized to by creating a custom graph based on the criteria you wish to use in identify the rings. For example, you can filter all devices with a specific technology and connectivity with a specific rate code for a specific area.

When you switch to the Ring Search, a pop-up message prompts you to proceed with the calculation of limited rings and the list of rings in the graph appears on the left side of the screen.

Note:

For very large graphs the calculation of rings is limited, but you can choose to calculate all rings for a moderate graph.

You can view ring information by selecting a ring from the list. The chosen ring is highlighted on the canvas, and the Ring Capacity panel appears on the right side of the canvas.

The Ring Capcity panel provides the following details:

Total Capacity: The total capacity of all edges within the ring.
Capacity Consumed: The sum of the capacity values of all edges within the ring.
A linear visualization of the ring with all nodes and the corresponding edges within the ring.

You can choose to view any number of rings or all rings available on the topology. When you select a ring, the associated nodes and edges appear in a tree view in the Ring Search panel. If the list of nodes/edges/rings is too long, then it is divided into different pages that can be viewed by clicking the page numbers listed next to the dropdown menu.

You can also filter rings using the filter chip options below the search bar. For example, if you select a filter chip for a specific location, all rings that are available within the filtered location in the rendered network appear. See "Viewing and Filtering Rings within a Searched Network" for more information.

The following image shows the ring search within a searched network:

Description of img_ringsearch_ata.png follows

Description of the illustration img_ringsearch_ata.png

Viewing and Filtering Rings within a Searched Network

To view rings within a searched network:

From the topology graph, click on the Search icon.
The search panel appears.
Select Ring Search from the dropdown list.
The list of all rings available within the network appears.
Select the required ring from the list.
The selected ring gets highlighted within the network along with Ring Capacity panel on the right side. You can see the list of nodes and edges associated with the selected ring in a tree view.

Note:
You can select multiple rings from the list of rings.

To filter rings:

Use the filter chip options available under search to view the rings available for that filtered criteria within the searched network.

Note:
You can use multiple filter chips to view the rings that meet the filtered criteria.
Click on the selected filter chip to change the value of the filter.
Search for any ring by its name or ID using the global search option.
Search for any node or edge within the ring using global search option.

4 Searching for Topology Graphs