Cisco Active Network Abstraction Network Service Activation 1.0 Customization Guide, 3.7
Cisco ANA Network Service Activation Customization Examples
ErrorMessage : Didn't tag either concept or doctype for selected page

null
Downloads: This chapterpdf (PDF - 583.0KB) The complete bookPDF (PDF - 3.55MB) | Feedback

Cisco ANA Network Service Activation Customization Examples

Table Of Contents

Cisco ANA Network Service Activation Customization Examples

Customization Examples Overview

Adding a New Attribute

Adding a New Service to the Activation List

Adding a New Service Group to the Activation List


Cisco ANA Network Service Activation Customization Examples


The following topics provide examples of Cisco ANA NSA customizations. Topics include:

Customization Examples Overview

Adding a New Attribute

Adding a New Service to the Activation List

Adding a New Service Group to the Activation List

Customization Examples Overview

The Cisco ANA NSA customization examples in this section are provided to help you understand key Cisco ANA NSA customization concepts. The examples show you how to add a new attribute to workflows and wizards, and how to customize the Activation window service list. You can perform the steps to see how these basic customizations are performed. After completing the procedures, you can complete the following steps to return your system to its shipped state:


Step 1 Use the Service Modification Utility to download the Layer 2 ACL metadata files from the Shipped category (see Downloading and Uploading Wizard Files, page 2-22).

Step 2 Upload the Layer 2 files you just downloaded (ACLPages.xml, ACLActivation.xml, and Service.xml).

This uploads the shipped metadata files to the Custom category and replaces the files customized in these sample procedures.

Step 3 Open Cisco ANA Workflow Editor and remove the attribute that you added in Adding a New Attribute.



Note To perform the metadata file customizations in these procedures, you will need a text or XML editor. You can use any editor that does not add a Byte Order Mark to the XML. For more information, see Cisco ANA NSA Customization Tools, page 1-6.


Adding a New Attribute

The following example shows the steps that you would follow to add a new attribute to an existing activation workflow and wizard. The example uses the Layer 2 ACL workflow (NSA_L2ACL.template). In this example, a new attribute, Access List Description, is added to the first page of the Create Layer 2 ACL wizard (Figure 6-1). You will first add the Access List Description attribute to the Layer 2 ACL workflow. Then you will add it to the Layer 2 ACL wizard metadata files.


Note For information about wizard metadata files, see Pages Files, page 2-2, and Activation Files, page 2-3.


Figure 6-1 Layer 2 ACL Wizard Before Customization


Step 1 Open Cisco ANA Workflow Editor.

Step 2 From the Tools menu, choose Retrieve Workflow from Server.

Step 3 In the Retrieve Workflow Template From Server dialog, select the NSA_L2ACL.template and click OK (Figure 6-2).

Figure 6-2 Retrieve Workflow Template From Server

The Layer 2 ACL workflow appears in the Workflow Editor.

Step 4 Right-click the workspace and choose Workflow Properties (Figure 6-3).

Figure 6-3 Retrieve Workflow Properties

The NSA_L2ACL.template Properties Sheet appears.

Step 5 Click the Attributes tab.

Step 6 In the Attribute Name field, enter ACL_description, then click Add (Figure 6-4).

Figure 6-4 Adding a Workflow Attribute

Step 7 From the Tools menu, choose Deploy Workflow.

Step 8 On the confirmation, click OK.

Now you will add the attribute to the Layer 2 ACL wizard pages and activation metadata files.

Step 9 Open Cisco ANA NetworkVision.

Step 10 From the Activation menu, choose Service Activation Utility.

Step 11 In the Service Metadata Modification Utility window, expand the Policy > ACL trees.

Step 12 Choose Create Layer 2 ACL and click Download (Figure 6-5),

Step 13 In the Download window, choose a local directory.

When you use the Cisco ANA NSA Service Modification Utility to download activation files, Cisco ANA NSA automatically downloads all applicable files including the pages, activation, and Service.xml files. For this example, you will see the following files in your local directory:

ACLActivation.xml

ACLPages.xml

Service.xml

Figure 6-5 Downloading the Create Layer 2 ACL Wizard Metadata

Step 14 Use your text or XML editor to open ACLPages.xml.

Step 15 Scroll to the <IMetaDataAttributes>.

Step 16 Copy the AclName (Access List Name) metadata and paste it directly beneath the AclName.


Tip Copying and pasting an existing MetaDataAttribute listing saves time, but is not required.


Step 17 Modify the following metadata:

<ID>—Change to AclDescription.

<AttributeDisplayName>—Change to Access List Description.

<Order>—Change to 3 (the description will appear after the ACL name on the wizard page).

Figure 6-6 shows the new AclDescription IMetaDataAttributes.

Figure 6-6 Modifying the ACLPages.xml File

Step 18 Save the file.

Step 19 Open the ACLActivation.xml file.

Step 20 Copy the ACLName IMetaDataAttribute and paste the text directly beneath it.

Step 21 Change the following metadata:

Change <ID> to ACL_Description.

Change <Value> to $Pages.Page1.AclDescription$.

Figure 6-7 shows the new AclDescription IMetaDataAttributes.

Figure 6-7 Modifying the ACLActivation.xml File

Step 22 Save the file.

Step 23 From the Cisco ANA NetworkVision Tools menu, choose Service Modification Utility.

Step 24 In the Service Metadata Modification Utility window, click Upload.

Step 25 In the file selection window (Figure 6-8), add the customized pages and activation files.

Figure 6-8 Uploading the Create Layer 2 ACL Wizard Pages and Activation Metadata Files

1

Customized ACLPages.xml upload.

2

Customized ACLActivation.xml upload.


Step 26 Click OK.


Note You will click OK to confirm each file upload.


Step 27 Close the Service Metadata Modification Utility window.

Step 28 From the Activation menu, choose Activation > Activation.

Step 29 In the Activation window, expand the Policy tree and choose Create Layer 2 ACL.

The new Access List Description attribute appears on the first Layer 2 ACL wizard page (Figure 6-9).

Figure 6-9 New Access List Description Attribute


Adding a New Service to the Activation List

After adding a new attribute in Adding a New Attribute, the following steps show how you can add the customized service as a new entry in the Activation window service activation list:


Step 1 Use your text or XML editor to open ACLPages.xml.

Step 2 Change the page name from ACLPages to ACLPages_NewService (Figure 6-10).

Figure 6-10 New Page Name

Step 3 Save the file.

Step 4 Open ACLActivation.xml.

Step 5 Give the activation a unique ID, in this example, ACLActivation_NewService (Figure 6-11).

Figure 6-11 New Activation ID

Step 6 Save the file.

Step 7 Open Service.xml.

Step 8 Scroll to the L2ACL IMetaDataList Entity entry (Figure 6-12).

Figure 6-12 L2ACL IMetaDataListingEntity

Step 9 Copy the entire L2ACL IMetaDataEntity entry.

Step 10 Scroll to the end of the file IMetaDataList, and paste the text as a new entry.


Tip The new MetaDataList entry can be placed anywhere between other MetaDataList entries as long as it is given a unique <Order>. However, placing it at the end makes it easier to identify and edit.


Step 11 Change the following:

<ID>—Change to L2ACL_NewService.

<Name>—Change to Create Layer 2 ACL - New Service.

<ActivationId>—Change to ACLActivation_NewService.

<Order>—Change to 19.

<PagesId>—Change to ACLPages_NewService.

The entry should look like the one shown in Figure 6-13.

Figure 6-13 L2ACL IMetaDataListingEntity

Step 12 Save your file.

Step 13 From the Cisco ANA NetworkVision Tools menu, choose Service Modification Utility.

Step 14 In the Service Metadata Modification Utility window, click Upload.

Step 15 In the file selection window (Figure 6-14), add the customized pages, activation, and Service.xml.

Figure 6-14 Downloading the Create Layer 2 ACL Wizard Metadata

1

Customized ACLPages.xml upload.

2

Customized ACLActivation.xml upload.

3

Customized Service.xml upload.


Step 16 Click OK.


Note You will click OK to confirm each file upload.


Step 17 Close the Service Metadata Modification Utility window.

Step 18 From the Activation menu, choose Activation > Activation.

Step 19 In the Activation window, expand the Policy tree and choose Create Layer 2 ACL.

The new Access List Description appears on the first Layer 2 ACL wizard page (Figure 6-15).

Figure 6-15 New Access List Description Attribute

Adding a New Service Group to the Activation List

After adding a new attribute in Adding a New Attribute, and creating a new service entry for it in Adding a New Service to the Activation List, this example shows how you can add the customized service to a new service group in the Activation window service list:


Step 1 Use your text or XML editor to open the Service.xml that you customized in Adding a New Service to the Activation List.

Step 2 Scroll to the new ACLPages_NewService at the end of the IMetaDataList.

Step 3 Change <Type> to Cisco Policy/Cisco ACL.

This creates a new Activation window tree group, Cisco Policy, and a subgroup, Cisco ACL.

Step 4 Save the file.

Step 5 From the Cisco ANA NetworkVision Tools menu, choose Service Modification Utility.

Step 6 In the Service Metadata Modification Utility window, click Upload.

Step 7 In the file selection window, add the customized Service.xml to the Service List Metadata box.

Step 8 Click OK.

Step 9 Close the Service Metadata Modification Utility window.

Step 10 From the Activation menu, choose Activation > Activation.

The new Cisco Policy group appears under the Policy group.

Step 11 In the Activation window, expand the Cisco Policy/Cisco ACL trees.

The new Create Layer 2 ACL - New Example wizard item is displayed within the new Cisco Policy/Cisco ACL groups (Figure 6-16).

Figure 6-16 New Activation Group