Page 1
Data Models Configuration Guide for Cisco NCS 1001 First Published: 2017-07-14 Last Modified: 2018-03-29 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883...
Page 2
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: /www.cisco.com/go/trademarks . Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company.
Remove Amplifier Configuration Configure Protection Switching Module Remove Protection Switching Module Configuration Configure OTS Controller Display Parameters of OTS Controllers Display Parameters of OTS OCH Controllers View PM Parameters for OTS Controllers Data Models Configuration Guide for Cisco NCS 1001...
Page 4
Contents Configuring NCS 1001 Using OpenConfig Data Model C H A P T E R 4 Openconfig Optical Amplifier Model Openconfig Protection Switching Model Openconfig Channel Monitoring Model Data Models Configuration Guide for Cisco NCS 1001...
7 Data Models - Programmatic and Standards-based Configuration Cisco IOS XR software supports the automation of configuration of multiple routers across the network using Data models. Configuring routers using data models overcomes drawbacks posed by traditional router management techniques.
HTTP/2 XML, JSON Each feature has a defined YANG model. Cisco-specific YANG models are referred to as synthesized models. Some of the standard bodies, such as IETF , IEEE and Open Config, are working on providing an industry-wide standard YANG models that are referred to as common models.
• leaf-list node - contains a sequence of leaf nodes • container node - contains a grouping of related nodes containing only child nodes, which can be any of the four node types Data Models Configuration Guide for Cisco NCS 1001...
The client can be a script or application typically running as part of a network manager. The server is typically a network device (router). For more NETCONF details, refer RFC 6241. Data Models Configuration Guide for Cisco NCS 1001...
Page 9
• <get>—Retrieves running configuration and device state information • <edit-config>—Loads all or part of a specified configuration to the specified target configuration • <get-schema>—Retrieves the required schema from the router NETCONF Operations: Example Data Models Configuration Guide for Cisco NCS 1001...
• Namespace selection - A namespace is considered to match (for filter purposes) if the XML namespace associated with a particular node within the filter element is the same as in the underlying data model. Data Models Configuration Guide for Cisco NCS 1001...
Although Protobufs was the only format supported in the initial release, gRPC is extensible to other content types. The Protobuf binary data object in gRPC is transported Data Models Configuration Guide for Cisco NCS 1001...
Page 12
• oper merge-config— Appends to an existing configuration • oper delete-config—Deletes a configuration • oper replace-config—Modifies a part of an existing configuration • oper get-oper—Gets operational data using JSON • oper cli-config—Performs a configuration • oper showcmdtextoutput Data Models Configuration Guide for Cisco NCS 1001...
Users can also query using NETCONF to get the list of models. <?xml version="1.0" encoding="utf-8"?> <rpc message-id="100" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <get> <filter type="subtree"> <netconf-state xmlns="urn:ietf:params:xml:ns:yang:ietf-netconf-monitoring"> <schemas/> </netconf-state> </filter> </get> </rpc> Data Models Configuration Guide for Cisco NCS 1001...
3 From the client application, connect to the router using Netconf on SSH. Run Netconf operations to make configuration changes or get operational data. Figure 4: Lane Diagram to show the router and client application operations Enabling Netconf This task enables Netconf over SSH. Data Models Configuration Guide for Cisco NCS 1001...
Step 2 Configure the gRPC port, using the grpc port command. RP/0/RP0/CPU0:ios(config)#grpc RP/0/RP0/CPU0:ios(config)#port 57400 RP/0/RP0/CPU0:ios(config)#tls RP/0/RP0/CPU0:ios(config)#commit Port can range from 57344 to 57999. If a port is unavailable, an error is displayed. Data Models Configuration Guide for Cisco NCS 1001...
Page 16
Using Data models Enabling gRPC Data Models Configuration Guide for Cisco NCS 1001...
Display Parameters of OTS OCH Controllers, page 24 • View PM Parameters for OTS Controllers, page 25 Supported YANG Models in NCS 1001 The supported configuration and operational YANG models for NCS 1001 are listed below. Cfg. yang Oper. yang Cisco-IOS-XR-ncs1001-ots-cfg.yang Cisco-IOS-XR-controller-optics-oper.yang...
Configuring NCS 1001 Using Data Models Configure Amplifier Module Configure Amplifier Module Use the Cisco-IOS-XR-ncs1001-ots-cfg.yang YANG model to configure the grid mode parameter of the amplifier module as 100GHz or 50GHz. Parameter Example grid-mode <?xml version="1.0"?> <rpc message-id="102" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <edit-config>...
<hardware-module xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-ncs1001-ots-cfg"> <node> <location>0_RP0_CPU0</location> <slot> <slot-id>0x3</slot-id> <psm> <manual-switch-to>working</manual-switch-to> </psm> </slot> </node> </hardware-module> </config> </edit-config> </rpc> Remove Protection Switching Module Configuration Use the Cisco-IOS-XR-ncs1001-ots-cfg.yang YANG model to remove the protection switching module configuration. Data Models Configuration Guide for Cisco NCS 1001...
</edit-config> </rpc> Configure OTS Controller Use the Cisco-IOS-XR-controller-optics-cfg.yang YANG model to configure the parameters of the OTS controller such as ampli-control-mode, ampli-channel-power, ampli-gain, ampli-gain-range, ampli-tilt, channel-power-max-delta, osri, safety-control-mode, rx-low-threshold, tx-low-threshold, rx-voa-attenuation, and tx-voa-attenuation. Data Models Configuration Guide for Cisco NCS 1001...
<config xmlns:xc="urn:ietf:params:xml:ns:netconf:base:1.0"> <interface-configurations xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-ifmgr-cfg"> <interface-configuration> <active>act</active> <interface-name>Ots0/3/0/1</interface-name> <optics xmlns="http://cisco.com/ns/yang/Cisco-IOS-XR-controller-optics-cfg"> <optics-ots-tx-voa-attenuation>135</optics-ots-tx-voa-attenuation> </optics> </interface-configuration> </interface-configurations> </config> </edit-config> </rpc> Display Parameters of OTS Controllers Use the Cisco-IOS-XR-controller-optics-oper.yang YANG model to display the parameters of OTS controllers. Data Models Configuration Guide for Cisco NCS 1001...
<optics-info /> </optics-port> </optics-ports> </optics-oper> </filter> </get> </rpc> Display Parameters of OTS OCH Controllers Use the Cisco-IOS-XR-controller-optics-oper.yang YANG model to display the parameters of OTS OCH controllers. Parameter Description show controllers ots-och <?xml version="1.0" ?> 0/2/0/0/1 <rpc message-id="8566" xmlns="urn:ietf:params:xml:ns:netconf:base:1.0"> <get>...
Configuring NCS 1001 Using Data Models View PM Parameters for OTS Controllers View PM Parameters for OTS Controllers Use the Cisco-IOS-XR-pmengine-oper.yang YANG model to view the performance monitoring parameters for OTS controllers. Parameter Example show controllers ots 0/2/0/0 <?xml version="1.0" ?>...
Page 30
Configuring NCS 1001 Using Data Models View PM Parameters for OTS Controllers Data Models Configuration Guide for Cisco NCS 1001...
Page 31
A complete list of supported open configuration models is available at https://github.com/openconfig. Cisco NCS1001 supports openconfig models according to the optical transport functions available on system. The following are the openconfig supported models: • Amplifier model, supported by NCS1001 EDFA modules •...
Page 33
Configuring NCS 1001 Using OpenConfig Data Model Openconfig Protection Switching Model Each EDFA module pluggable within Cisco NCS1001 slot contains two optical amplifiers such as a booster and a pre-amplifier. The list of components applicable as amplifier name is listed in the following table:...
Page 34
+--ro min? decimal64 +--ro max? decimal64 Inventory Details The Cisco NCS1001 PSM pluggable module is provided through the following inventory information: Component Naming Convention EDFA Module, PSM 0/S-PSM-OM Openconfig Channel Monitoring Model The following is the tree structure of OpenConfig Channel Monitor model:...
Page 35
Configuring NCS 1001 Using OpenConfig Data Model Openconfig Channel Monitoring Model EDFA Module, Booster Amplifier OCM 0/S-CHMON-BST Data Models Configuration Guide for Cisco NCS 1001...
Page 36
Configuring NCS 1001 Using OpenConfig Data Model Openconfig Channel Monitoring Model Data Models Configuration Guide for Cisco NCS 1001...