Template Management

Template management allows users to create and manage XML configuration templates locally on the UCS NID controller. These configuration templates can be stored on UCS controller and applied to one or more ME1200 NIDs. When used along with Bulk Provisioning feature, user can apply template XML to multiple NIDs which are part of one or more pre-configured groups. By definition, a configuration template is any technology-specific (for example, EVC, VLAN, QoS, MEP, and so on) or service-specific (ELINE, ELAN etc.) set of operations that result in provisioning of Metro Ethernet services on ME1200 NID. The benefits of using template management include the following:

  • Ability to create a customized template XML file based on user configuration.

  • Dedicated configuration mode for template management operations.

  • Fetches existing running configuration template from operational NID, locally storing the same or customized template, and applying these to a single or group of NIDs.

Prerequisites for Configuring Template Management

  • NID must be added to the controller.

  • NID must be accessible from the controller.

How to Configure Template Management

Configuring Template Management

     Command or ActionPurpose
    Step 1platform template


    Example: 
    UCS# platform template
     

    Enter template management configuration mode.

     
    Step 2create template


    Example: 
    UCS(template)# create template <filename.xml>
     

    Create custom template by specifying XML file name <filename.xml>. This command causes a new terminal window to be opened to configure one or more technology templates.

     
    Step 3Template Create operations
          		The new terminal created in step 2 Template Create can be used to configure template operations using the various technologies. For each technology template below, you can perform the corresponding Set or Get operation. The available technologies for template management are:
    • ACLDefinition: Template for actual ACL definitions.
    • EpsPortType: Provision EPS.
    • ErpsPortType: Provision ERPS.
    • FlexlinksPortType: Provision Flexlink Backup Interface Configuration.
    • LinkOamPortType: Provision linkoam.
    • LSTPortType: Provision Link State Tracking.
    • NtpPortType: Provision NTP.
    • OperationsMepPortType: Enables fault management and performance monitoring on MEP.
    • ProvisionACL: Provision ACL Configuration.
    • ProvisionEVC: EVC operations.
    • ProvisionL2CPPortType: Provision L2CP Service on EVCs.
    • ProvisionLacpPortType: Provision LACP service.
    • ProvisionLldpPortType: Provision LLDP Service.
    • ProvisionMacTableSecurityType: Clear MAC Address Table Entries.
    • ProvisionMepPortType: Provision MEP.
    • ProvisionPhyPortType: Physical Port Configuration.
    • ProvisionPortVlanPortType: Provision Vlan and SwitchPort Service.
    • ProvisionQos: Configure QoS features.
    • ProvisionSnmpConf: Set snmp config.
    • ProvisionStormControl: Provision Storm Control Service.
    • ProvisionStpPortType: Provision STP Services.
    • PTPPortType: ME1200 PTP operations.
    • RFC2544PortType: RFC2544 port type.
    • SFlow: sFlow operations.
    • SPAN: SPAN Global Configuration.
    • SyncE: Set SyncE global configuration.
    • sysLog: Syslog Properties and Methods.
    • UDLDPortType: Provision UDLD Configuration.
    • y1564: Provision Y1564.
     
    Step 4exit


    Example: 
    UCS# exit
          		After configuring the required operations, exit the template shell. A file by the name<filename.xml> is created in the following directory: <user-home-dir>/ucsNIDCtrlr/config-templates/. Check the XML data written into template file.  
    Step 5 configure nid 1


    Example: 
    UCS# configure nid <nid_id> or configure group <nid_group_name>


    Example: 
    UCS# ConfigTemplatePortType 
UCS(ConfigTemplatePortType)#
UCS(ConfigTemplatePortType)# applyCfgTemplate 
pushConfigXML 
templateFile file1.xml
          		Apply the template XML file created on ME1200 NID to a single NID or NID group.  
    Step 6applyCfgTemplate review


    Example: 
    UCS(ConfigTemplatePortType)# applyCfgTemplate 
review
          		Review apply or push configuration template command to NID or NID group.  
    Step 7 applyCfgTemplate commit


    Example: 
    UCS(ConfigTemplatePortType)# applyCfgTemplate 
commit
          		Commit apply or push configuration template command to NID or NID group.  
    Step 8 exit


    Example: 
    UCS(ConfigTemplatePortType)# exit
          		Exit the ConfigTemplatePortType mode.  
    Step 9 UCS(template)# fetchconfigxml


    Example: 
    UCS(template)# fetchconfigxml nid 2
          		Fetches the configurations from a file and saving locally.  
    Step 10fetchconfigxml commit


    Example: 
    UCS(template)# fetchconfigxml commit
          		Fetch file is created and saved at = /users/<user_name>/UCS/ ucsNIDCtrlr/config-templates/ nid2-running-config.xml Commits the template.  
    Step 11fetchconfigxml review


    Example: 
    UCS(template)# fetchconfigxml review
          		Review the command for fetching XML configuration from operational NID.  
    Step 12fetchconfigxml commit


    Example: 
    UCS(template)# fetchconfigxml commit
          		Commit Fetch operation  
    Step 13Exit


    Example: 
    UCS(template)# exit
          		Exit from template management mode.  

    Configuration Example

    UCS# ProvisionEVC ? 
EVC operations
UCS# ProvisionEVC 
UCS(ProvisionEVC)# 
addECE                   
addECE_v2      Add ECE [Port range extended]
addEVC                   
addEVC_v2      Add EVC [Port range extended]
addPolicerEVC  Add EVC policer
debug          Change to the debug mode
deleteECE                
deleteEVC                
deletePolicerEVC   Delete EVC policer
disableEVCpolicer        
editECEConfiguration     
editEVCConfiguration     
editEVCConfiguration_v2 Update EVC parameters [Port range extended]
enableEVCpolicer         
exit               Exit the named view
getECEBlankForm          
getECEBlankForm_v2  Get ECE Blank Form [Port range extended]
getECEconfiguration      
getECEconfiguration_v2 Get ECE Configuration [Port range extended] 
getECECounters           
getEVC_Counters     getevc Counters
getEVCBlankform     getEVCBlankform
getEVCBlankForm_v2   Get EVC Blank Form [Port range extended]
getEVCconfiguration      
getEVCconfiguration_v2   Get EVC configuration [Port range extended] 
help    Display an overview of the CLI syntax
history Display the current session's command line history
logout  Logout of the current CLI session
modifyEVCpolicer         
reorderECEentries        
script         Change to the script demo mode
top            Return to the default mode

    Configure a new ECE ID. 

    UCS(ProvisionEVC)# addECE ece_configuration ece_id 1
AddECE Commit Success!!!

    Validate configuration for newly configured ECE ID. 

    UCS(ProvisionEVC)# getECEconfiguration getECEconfig 1
UCS(ProvisionEVC)# getECEconfiguration review 

Commands in queue:
        getECEconfiguration getECEconfig 1
UCS(ProvisionEVC)# getECEconfiguration commit
Connection to web service opened
Decoding was successful
Decoded record:
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.ece_id = 1
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.uni_ports.
GigabitEthernet_1_UNI = false
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.uni_ports.
GigabitEthernet_2_UNI = false
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.uni_ports.
GigabitEthernet_3_UNI = false
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.uni_ports.
GigabitEthernet_4_UNI = false
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.uni_ports.
GigabitEthernet_5_UNI = false
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.uni_ports.
GigabitEthernet_6_UNI = false
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.
outer_tag_match.match_type.t = 1
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.
outer_tag_match.match_type.u.any = 'default'
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.
outer_tag_match.match_fields.vlan_id_filter.t = 2
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.
outer_tag_match.match_fields.vlan_id_filter.u.range = '0-4095'
GetECEconfiguration_Output.ece_config_get_response.ece_configuration.control.ingress_match.
outer_tag_match.match_fields.inner_pcp.t = 15
…
UCS(ProvisionEVC)#exit
UCS#