Viewing a fabric intent

Follow this procedure to view a previously created fabric intent.
  1. Click the menu.
  2. Select Fabric Intents.
  3. To open a specific fabric intent from the list, do one of the following:
    • Double-click the row for that fabric intent.
    • Select a row, click the icon at the right edge of that row, and select Open from the displayed action list.

Groups

Groups represent multiple nodes in your fabric's topology. When a fabric consists of many nodes, the topology can grow complicated. Groups simplify the display of such complicated structures to make them more comprehensible at a glance.

The maximum number of nodes represented by a single group is a variable you can set with the Clustering Controls display setting (as described in Display controls). The system automatically adds more groups to the display to represent additional nodes beyond this threshold.

You can click the control for any group to expand it; the node is replaced by the set of individual nodes it represented.

Figure 1. Node group
Table 1. Group elements

Element

Description

1

Expand control

Click this control to expand the group and display its individual nodes.

2

Deployment issue flag

This displays only if there are issues associated with the deployment of configuration data to one or more nodes in the group.

3

Status summary

This is a pie chart that indicates the proportion of nodes in the group that are the subject of alerts, versus those that are not. Errors are represented by the orange segment.

4

Link attachment point

Links to other nodes originate from one of these points at the edge of the group icon.

To expand a group, click the control at the top-left corner of the group.

To collapse an expanded group, click the control in the same position.

Figure 2. Expanded group

The symbol for each node indicates its role as spine, leaf, or backbone as shown in Icons for fabric intents.

Figure 3. Icons for fabric intents

Information displays

You can hover the cursor over a node or group in the fabric intent Design view to see details about that object.

Figure 4. Hovering over a group

You can also expand the information panel on the right side of the page by clicking . The information panel shows more details about the currently selected object in the fabric topology (either a group, a node, or a link).

Figure 5. Information panel for a group

Error indicators

The Fabric Services System UI provides a number of cues to draw your attention to problem areas in your fabric intent. Highlights and symbols in the topology display identify groups and nodes that are the subject of one or more errors.

Table 2. Node shading

Element

Description

Operational Normal: this node or group is in good order and in an operational state.

Intent Matching: this node or group is configured as described in the original fabric intent.

Intent Deviation: this node or group has been configured differently than specified in the original fabric intent. This arises when someone outside of the Fabric Services System alters the node configuration after the deployment of your fabric intent.

Operational Issue: this node or group is not operational or its operation is impaired. Check the Alerts list to identify the operational issue that is affecting the object.

Missing Hardware: this node or group is identified as "real" in the fabric intent, but no corresponding real-world hardware has been associated with it.

Maintenance: this node or group is subject to a Maintenance intent (either to replace a node with new matching hardware, or to update the node's software load).

The Status Summary at the bottom of the page shows general information about the fabric intent's progress and status.

Figure 6. Status Summary (expanded)
  • Stage: The current fabric intent's progress through its development stages toward deployment, including:
    • Created: A user has selected a template, supplied basic parameters, and elected to proceed with fabric generation.
    • Topology Generated: the system has generated the fabric topology.
    • Configuration Generated: the system has generated the configuration files for individual nodes participating in the fabric, based on the current fabric intent design.
    • Deployment Done: Tracked separately for the Digital Sandbox and real hardware, this indicates that the necessary configurations have been applied to the nodes participating in the fabric.
  • Status: These indicators show a count of nodes within the current fabric that are in various states, as described in Node shading.

Viewing the event log

The Fabric Services System maintains a unique event log for every fabric intent, showing significant events in the history of the fabric intent including a time stamp and the outcome of each event.
Figure 7. Event Log for a fabric intent

To view the event log for a fabric intent:

  1. Click the menu.
  2. Select Fabric Intents.
  3. To open a specific fabric intent from the list, do one of the following:
    • Double-click the row for that fabric intent.
    • Select a row, click the icon at the right edge of that row, and select Open from the displayed action list.
  4. From the opened fabric intent, click the menu at the upper right of the page.
  5. Select Event Log from the action list.
  6. To exit the event log, click the CLOSE button.

Display controls

Display controls allow you to manipulate the way objects are displayed within the fabric topology of the Design view.

Figure 8. Display controls on the fabric intents page
Table 3. Display controls

Icon

Description

Fit to screen: Adjusts the magnification setting for the topology display so that the entire topology diagram fits inside the current window.

Clustering controls:

  • enables or disables the use of groups on the map

  • sets the grouping density (the maximum number of nodes represented by a single group)

Adjust links: Allows you to control the way links are displayed in the fabric topology.

Zoom in, Zoom out: Increases or decreases the magnification for the topology diagram.

Viewing a fabric intent as code

You can view the configuration code that the system has generated to represent the current fabric. This can be helpful for verifying the design in detail, and possibly revising the fabric design if needed.
  1. Click the menu.
  2. Select Fabric Intents.
  3. To open a specific fabric intent from the list, do one of the following:
    • Double-click the row for that fabric intent.
    • Select a row, click the icon at the right edge of that row, and select Open from the displayed action list.
  4. Click to open the code view.
  5. Optional: Do any of the following:
    • To save the fabric code in a local file, click and choose a location and name for the file.
    • To copy a portion of the code, select the code and click . The system adds the selection to your clipboard.
    • To find a particular string of text within the fabric code, click and enter the text string.

      The first instance is highlighted; use the arrows to navigate forward or backward to additional instances, or click ALL to highlight all instances simultaneously.

  6. To compare the current fabric code against the code for a previous version of the same fabric:
    1. At the end of the "breadcrumb" list at the upper left of the overlay, in the drop-down list, click Compare Versions.
    2. Click the Compare To drop-down list and select a different version number of the current fabric from the list.
    3. Click the Expand <number> lines link to view the full fabric code displayed in two panels, one for each version.
    4. Optional: Repeat step 6.b to select another version of the same fabric against which to compare the current version's code.
  7. To view the code for an individual node within the fabric:
    1. At the end of the "breadcrumb" list at the upper left of the overlay, in the drop-down list, click Fabric Elements.
    2. Click a node in the left column to see its current configuration code.
    3. Click the Expand <number> lines link to view the full fabric code displayed in two panels, one for each version.
    4. Optional: To see the normalized version of the same node's code, click the drop-down list at the upper right of the overlay and select Normalized.
  8. When finished viewing the fabric as code, click at the upper right of the overlay to return to the Fabric Design view.

Viewing the configuration file for a single node

You can view the configuration file that the system has generated for each node in the inventory. Viewing the configuration file can be helpful for verifying the precise configuration that is planned for the node and possibly revising the configuration if needed.

Follow this procedure to view the current configuration planned for a single node.

  1. Click to open the main menu, then select Inventory.
  2. Find the node and click at the end of its row.
  3. Select Inspect Configuration from the displayed actions list.
  4. Optional: Do any of the following:
    • To save the fabric configuration in a local file, click and choose a location and name for the file.
    • To copy a portion of the fabric configuration, select the portion and click . The selection is added to your clipboard.
    • To find a particular string of text within the fabric configuration, click and enter the text string. The first instance is highlighted; use the arrows to navigate forward or backward to additional instances, or click ALL to highlight all instances simultaneously.
  5. Click at the upper right of the overlay to close the Inspect Configuration overlay.

Downloading the initial node configuration

You can download a file containing the initial configuration code for all of the nodes participating in the current fabric intent.

To download the configuration file:

  1. Click the menu.
  2. Select Fabric Intents.
  3. To open a specific fabric intent from the list, do one of the following:
    • Double-click the row for that fabric intent.
    • Select a row, click the icon at the right edge of that row, and select Open from the displayed action list.
  4. From the opened fabric intent, click the menu at the upper right of the page.
  5. Select Download Initial Node Configuration from the list. The system immediately downloads the file "initialNodeConfigs" to your Downloads folder.
  6. To view the configuration, open the initlalNodeConfigs file in a text editor.

Viewing the fabric inventory

You can open a fabric intent's Fabric Inventory view to see a list of all of the nodes that are included in the fabric design. The Inventory view displays extensive details about each node, including its role in the current fabric intent.

This list is a subset of the full inventory; it shows only the nodes participating in the current fabric intent.

From this view you can edit labels for nodes, associate planned nodes with real hardware, inspect an individual node's configuration code, and download a mapping file to help with node association. For more information about the complete inventory and the full set of actions available from any inventory view, see Inventories.

To open the Inventory view for a single fabric intent:

  1. Open a fabric intent
  2. Click the menu.
  3. Select Fabric Intents.
  4. To open a specific fabric intent from the list, do one of the following:
    • Double-click the row for that fabric intent.
    • Select a row, click the icon at the right edge of that row, and select Open from the displayed action list.
  5. Click the View drop-down list and select Fabric Inventory.
  6. To return to the Fabric Design view or open another view, make the corresponding selection from the View drop-down list.

Generating a wiring plan

You can generate a wiring plan to assist technicians when installing and connecting the fabric's planned, supporting hardware.

The wiring plan is in the form of a .csv file that identifies all of the connected pairs of nodes participating in the fabric, their roles (for example leaf or spine), and the ports on each node that serve as endpoints for their interconnections.

To generate a wiring plan:

  1. Click the menu.
  2. Select Fabric Intents.
  3. To open a specific fabric intent from the list, do one of the following:
    • Double-click the row for that fabric intent.
    • Select a row, click the icon at the right edge of that row, and select Open from the displayed action list.
  4. Click the More actions icon () to open the actions menu and select Generate Wiring Plan...
    The system generates and saves a file with the name <fabric name>_wiringPlan.csv.