Cisco Active Network Abstraction Customization User Guide, 3.6.6 - Soft Property Examples [Cisco Active Network Abstraction]

Table Of Contents

Soft Property Examples

Basic Soft Property Example

Soft Property Example Including a TCA

Soft Property Table Example

Soft Property Examples

This chapter provides several examples that describe how to create a soft property from start to finish, including defining TCAs and a soft property table:

•Basic Soft Property Example

•Soft Property Example Including a TCA

•Soft Property Table Example

Basic Soft Property Example

To create a basic soft property (excluding a TCA):

Step 1 Do one of the following:

•Right-click a managed element in Cisco ANA NetworkVision or the workspace.

•In Cisco ANA NetworkVision, open the Inventory window for the required managed element, then right-click the required object.

Step 2 Choose Management > Soft Properties Management. The Soft Properties Manager window is displayed.

Step 3 Select the required property from the drop-down list in the properties panel.

Step 4 Open the Add Soft Property dialog box in one of the following ways:

•Click New Element on the toolbar.

•Choose File > New Element.

Step 5 Define the soft property information in the General tab as follows:

•Name—sp01

•Label—My Soft Property

•Description—Example of soft property

•Type—Property

•Polling Rate—Status

•Enabled—Selected

Step 6 Select the Parsing tab.

Step 7 Define the information in the Parsing tab as follows:

•Select Use Telnet/SSH.

•In the text box, enter show ip vrf example.

Step 8 Click Add. The Add/Edit Parsing Rule dialog box is displayed (see Figure 4-1).

Figure 4-1 Add/Edit Parsing Rule Dialog Box

Step 9 Define the information in the Add/Edit Parsing Rule dialog box as follows:

•Operator—Match

•Expression—\d\d

•Source text box—Enter the information as shown in the example.

Step 10 Click Test Expression. The result 55 is displayed in the Result text box.

Step 11 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed.

Figure 4-2 Add Soft Property Dialog Box

Step 12 Click Add. The Add/Edit Parsing Rule dialog box is displayed.

Figure 4-3 Add/Edit Parsing Rule Dialog Box

Step 13 Define the information in the Add/Edit Parsing Rule dialog box as follows:

•Operator—Substring

•From Index—1

•To Index—1

•Source text box—55

Step 14 Click Test Expression. The result 5 is displayed in the Result text box.

Step 15 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed.

Figure 4-4 Parsing Tab

Step 16 Click Test. The Test Parsing Rules dialog box is displayed, enabling you to test all defined parsing rules in the order given.

Figure 4-5 Test Parsing Rules Dialog Box

Step 17 Click Test. The result of the test is displayed in the Output Buffer area.

Step 18 Click Close. The Add Soft Property dialog box is displayed.

Step 19 Click Debug. The Debug Soft Property dialog box is displayed.

Figure 4-6 Debug Soft Property Dialog Box

Step 20 After the Status is returned as valid, confirm that the input parameters have returned the correct values; for example:
Telnet Commands=[show ip vrf example] 
Step 21 Click Close. The Add Soft Property dialog box is displayed.

(To add a TCA, go to Step 2 in Soft Property Example Including a TCA).

Step 22 Click OK. The Soft Properties Manager window is displayed.

Figure 4-7 Soft Properties Manager Window

Step 23 Click Close. The Cisco ANA NetworkVision window or Inventory window is displayed, depending on your original selection.

Step 24 To view the newly created soft property:

•Click the top right corner to close the Inventory window, then open it again.

•Move up and down a branch in the tree pane of the Inventory window.

The Inventory window for the required managed element is displayed with the newly defined soft property.

Figure 4-8 Inventory Window

Step 25 In Cisco ANA NetworkVision:

•Right-click the required managed element in the tree pane or workspace.

•Right-click the required object of the network element in the Inventory window.

Step 26 Choose Management > Soft Properties Management. The Soft Properties Manager window is displayed.

Step 27 Select the required properties panel and soft property in the element properties table.

Step 28 Open the hierarchy manager table in one of the following ways:

•Click Hierarchy Manager in the toolbar.

•Choose Tools > Hierarchy Manager.

•Right-click the item, then choose Hierarchy Manager.

Step 29 Select the node in the hierarchy from which you want to publish the soft property.

Step 30 Click Copy or Cut in the toolbar to copy or cut the soft property.

Step 31 Select the required node in the hierarchy where you want to publish the soft property.

Step 32 Click Paste in the toolbar to paste the soft property. The soft property is published to the selected node in the hierarchy.

Step 33 Click Close. The Soft Properties Manager window is displayed.

For more information about defining a soft property with a TCA, see Soft Property Example Including a TCA.

Soft Property Example Including a TCA

To create a soft property including a TCA:

Step 1 Perform Step 1 through Step 20, as described in the Basic Soft Property Example.

Step 2 Select the TCA Alarms tab.

Step 3 Click Add. The General tab of the Add TCA dialog box is displayed.

Step 4 Define the information in the TCA Alarms tab as follows:

•Name—My value is not 5.

•Enabled—Selected.

•Description—Show this alarm if the value is not equal to 5.

•Alarm Severity—CRITICAL.

Step 5 Select the Trigger tab in the Add TCA dialog box.

Step 6 Define the information in the Trigger tab as follows:

•Trigger—Value Not Equal.

•To value—5

Step 7 Click OK. The TCA Alarms tab is displayed with the defined TCA.

Step 8 Click OK. The Soft Properties Manager window is displayed.

Step 9 Click Close. The Cisco ANA NetworkVision window or the Inventory window is displayed, depending on your original selection.

Step 10 To view the newly created soft property:

•Click the top right corner to close the Inventory window, then open it again.

•Move up and down a branch in the tree pane of the Inventory window.

The Inventory window for the required managed element is displayed with the newly defined soft property.

Figure 4-9 displays the Inventory window before the defined alarm is triggered.

Figure 4-9 Inventory Window Before Alarm Triggered

Figure 4-10 displays the Inventory window after the alarm has been triggered.

Figure 4-10 Inventory Window After Alarm Triggered

Figure 4-11 displays the Inventory window after the alarm has been cleared.

Figure 4-11 Inventory Window After Alarm Cleared

Step 11 Perform Step 24 through Step 33, as described in Basic Soft Property Example.

For more information about defining a soft property table, see Soft Property Table Example.

Soft Property Table Example

To create a soft property table:

Step 1 Perform Step 1 and Step 2, as described in the Soft Property Example Including a TCA.

Step 2 Open the Add Soft Property dialog box in one of the following ways:

•Click New Element in the toolbar.

•Choose File > New Element.

Step 3 Define the soft property information in the General tab as follows:

•Name—sp02

•Label—My Soft Table

•Description—Example of a soft table

•Type—Table

•Polling Rate—Status

•Enabled—Selected

Step 4 Select the Parsing tab. The Parsing tab is displayed.

Step 5 Define the information in the Parsing tab by entering .1.3.6.1.2.1.4.20.1 in the text box.

Step 6 Click Add. The Add Edit Column Controller dialog box is displayed.

Step 7 Define the information in the Add Edit Column Controller dialog box as follows:

•Column Title—My First Column

•Column Data—2

Step 8 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed with the defined table information for column 1 of the table.

Step 9 Click Add. The Add Edit Column Controller dialog box is displayed.

Step 10 Define the information in the Add Edit Column Controller dialog box as follows:

•Column Title—My Second Column

•Column Data—3

Step 11 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed with the defined table information for columns 1 and 2 of the table.

Figure 4-12 Add Soft Property Dialog Box

Step 12 Click Debug. The Debug Soft Property dialog box is displayed.

Step 13 Click Close. The Add Soft Property dialog box is displayed.

Step 14 Click OK. The Soft Properties Manager window is displayed.

Step 15 Click Close. The Cisco ANA NetworkVision window or the Inventory window is displayed, depending on your original selection.

Step 16 To view the newly created soft property:

•Click the top right corner to close the Inventory window, then open it again.

•Move up and down a branch in the tree pane of the Inventory window.

The Inventory window for the required managed element is displayed with the newly defined soft property table (see Figure 4-13).

Figure 4-13 Inventory Window

Step 17 Perform Step 24 through Step 33, as described in the Basic Soft Property Example.

	Cisco Active Network Abstraction Customization User Guide, 3.6.6
	Soft Property Examples
Cisco Active Network Abstraction Customization User Guide, 3.6.6 Preface Overview Cisco ANA Overview Customizing Network Element Information Using the Soft Properties Manager Introducing the Cisco ANA Soft Properties Manager Getting Started with the Soft Properties Manager Soft Property Examples Parsing Operators/Rules Alarm Threshold Triggers Regular Expressions Using the Workflow Editor to Create Task Workflows Introducing the Cisco ANA Workflow Editor Working With the Cisco ANA Workflow Editor Getting Started with the Workflow Editor Managing Workflows Customizing the Workflow Editor Managing and Deploying Configuration Changes Using the Command Builder Introducing the Command Builder Getting Started with the Command Builder Creating an ANA Macro Language Command: An Example Running Command Scripts ANA Macro Language Bean Shell Commands Using the Shell Interface Introducing the Cisco ANA Shell Interface Understanding Cisco ANA Shell Behavior Regular Expressions Cisco ANA Shell Potential Errors Working with BQL Getting Started with BQL Understanding IMO IMO Specification BQL Generic Commands Encrypted SSL Sockets Detailed BQL Errors Catalog and Examples Best Practices for Integration BQL Parsing Index	Download this chapter Soft Property Examples Download the complete book PDF of Cisco ANA 3.6.6 Customization User Guide (PDF - 4 MB) Table Of Contents Soft Property Examples Basic Soft Property Example Soft Property Example Including a TCA Soft Property Table Example Soft Property Examples This chapter provides several examples that describe how to create a soft property from start to finish, including defining TCAs and a soft property table: •Basic Soft Property Example •Soft Property Example Including a TCA •Soft Property Table Example Basic Soft Property Example To create a basic soft property (excluding a TCA): Step 1 Do one of the following: •Right-click a managed element in Cisco ANA NetworkVision or the workspace. •In Cisco ANA NetworkVision, open the Inventory window for the required managed element, then right-click the required object. Step 2 Choose Management > Soft Properties Management. The Soft Properties Manager window is displayed. Step 3 Select the required property from the drop-down list in the properties panel. Step 4 Open the Add Soft Property dialog box in one of the following ways: •Click New Element on the toolbar. •Choose File > New Element. Step 5 Define the soft property information in the General tab as follows: •Name—sp01 •Label—My Soft Property •Description—Example of soft property •Type—Property •Polling Rate—Status •Enabled—Selected Step 6 Select the Parsing tab. Step 7 Define the information in the Parsing tab as follows: •Select Use Telnet/SSH. •In the text box, enter show ip vrf example. Step 8 Click Add. The Add/Edit Parsing Rule dialog box is displayed (see Figure 4-1). Figure 4-1 Add/Edit Parsing Rule Dialog Box Step 9 Define the information in the Add/Edit Parsing Rule dialog box as follows: •Operator—Match •Expression—\d\d •Source text box—Enter the information as shown in the example. Step 10 Click Test Expression. The result 55 is displayed in the Result text box. Step 11 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed. Figure 4-2 Add Soft Property Dialog Box Step 12 Click Add. The Add/Edit Parsing Rule dialog box is displayed. Figure 4-3 Add/Edit Parsing Rule Dialog Box Step 13 Define the information in the Add/Edit Parsing Rule dialog box as follows: •Operator—Substring •From Index—1 •To Index—1 •Source text box—55 Step 14 Click Test Expression. The result 5 is displayed in the Result text box. Step 15 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed. Figure 4-4 Parsing Tab Step 16 Click Test. The Test Parsing Rules dialog box is displayed, enabling you to test all defined parsing rules in the order given. Figure 4-5 Test Parsing Rules Dialog Box Step 17 Click Test. The result of the test is displayed in the Output Buffer area. Step 18 Click Close. The Add Soft Property dialog box is displayed. Step 19 Click Debug. The Debug Soft Property dialog box is displayed. Figure 4-6 Debug Soft Property Dialog Box Step 20 After the Status is returned as valid, confirm that the input parameters have returned the correct values; for example: Telnet Commands=[show ip vrf example] Step 21 Click Close. The Add Soft Property dialog box is displayed. (To add a TCA, go to Step 2 in Soft Property Example Including a TCA). Step 22 Click OK. The Soft Properties Manager window is displayed. Figure 4-7 Soft Properties Manager Window Step 23 Click Close. The Cisco ANA NetworkVision window or Inventory window is displayed, depending on your original selection. Step 24 To view the newly created soft property: •Click the top right corner to close the Inventory window, then open it again. •Move up and down a branch in the tree pane of the Inventory window. The Inventory window for the required managed element is displayed with the newly defined soft property. Figure 4-8 Inventory Window Step 25 In Cisco ANA NetworkVision: •Right-click the required managed element in the tree pane or workspace. •Right-click the required object of the network element in the Inventory window. Step 26 Choose Management > Soft Properties Management. The Soft Properties Manager window is displayed. Step 27 Select the required properties panel and soft property in the element properties table. Step 28 Open the hierarchy manager table in one of the following ways: •Click Hierarchy Manager in the toolbar. •Choose Tools > Hierarchy Manager. •Right-click the item, then choose Hierarchy Manager. Step 29 Select the node in the hierarchy from which you want to publish the soft property. Step 30 Click Copy or Cut in the toolbar to copy or cut the soft property. Step 31 Select the required node in the hierarchy where you want to publish the soft property. Step 32 Click Paste in the toolbar to paste the soft property. The soft property is published to the selected node in the hierarchy. Step 33 Click Close. The Soft Properties Manager window is displayed. For more information about defining a soft property with a TCA, see Soft Property Example Including a TCA. Soft Property Example Including a TCA To create a soft property including a TCA: Step 1 Perform Step 1 through Step 20, as described in the Basic Soft Property Example. Step 2 Select the TCA Alarms tab. Step 3 Click Add. The General tab of the Add TCA dialog box is displayed. Step 4 Define the information in the TCA Alarms tab as follows: •Name—My value is not 5. •Enabled—Selected. •Description—Show this alarm if the value is not equal to 5. •Alarm Severity—CRITICAL. Step 5 Select the Trigger tab in the Add TCA dialog box. Step 6 Define the information in the Trigger tab as follows: •Trigger—Value Not Equal. •To value—5 Step 7 Click OK. The TCA Alarms tab is displayed with the defined TCA. Step 8 Click OK. The Soft Properties Manager window is displayed. Step 9 Click Close. The Cisco ANA NetworkVision window or the Inventory window is displayed, depending on your original selection. Step 10 To view the newly created soft property: •Click the top right corner to close the Inventory window, then open it again. •Move up and down a branch in the tree pane of the Inventory window. The Inventory window for the required managed element is displayed with the newly defined soft property. Figure 4-9 displays the Inventory window before the defined alarm is triggered. Figure 4-9 Inventory Window Before Alarm Triggered Figure 4-10 displays the Inventory window after the alarm has been triggered. Figure 4-10 Inventory Window After Alarm Triggered Figure 4-11 displays the Inventory window after the alarm has been cleared. Figure 4-11 Inventory Window After Alarm Cleared Step 11 Perform Step 24 through Step 33, as described in Basic Soft Property Example. For more information about defining a soft property table, see Soft Property Table Example. Soft Property Table Example To create a soft property table: Step 1 Perform Step 1 and Step 2, as described in the Soft Property Example Including a TCA. Step 2 Open the Add Soft Property dialog box in one of the following ways: •Click New Element in the toolbar. •Choose File > New Element. Step 3 Define the soft property information in the General tab as follows: •Name—sp02 •Label—My Soft Table •Description—Example of a soft table •Type—Table •Polling Rate—Status •Enabled—Selected Step 4 Select the Parsing tab. The Parsing tab is displayed. Step 5 Define the information in the Parsing tab by entering .1.3.6.1.2.1.4.20.1 in the text box. Step 6 Click Add. The Add Edit Column Controller dialog box is displayed. Step 7 Define the information in the Add Edit Column Controller dialog box as follows: •Column Title—My First Column •Column Data—2 Step 8 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed with the defined table information for column 1 of the table. Step 9 Click Add. The Add Edit Column Controller dialog box is displayed. Step 10 Define the information in the Add Edit Column Controller dialog box as follows: •Column Title—My Second Column •Column Data—3 Step 11 Click OK. The Parsing tab of the Add Soft Property dialog box is displayed with the defined table information for columns 1 and 2 of the table. Figure 4-12 Add Soft Property Dialog Box Step 12 Click Debug. The Debug Soft Property dialog box is displayed. Step 13 Click Close. The Add Soft Property dialog box is displayed. Step 14 Click OK. The Soft Properties Manager window is displayed. Step 15 Click Close. The Cisco ANA NetworkVision window or the Inventory window is displayed, depending on your original selection. Step 16 To view the newly created soft property: •Click the top right corner to close the Inventory window, then open it again. •Move up and down a branch in the tree pane of the Inventory window. The Inventory window for the required managed element is displayed with the newly defined soft property table (see Figure 4-13). Figure 4-13 Inventory Window Step 17 Perform Step 24 through Step 33, as described in the Basic Soft Property Example.
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.