cisco_node_utils 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 860be08b4fe2ad44a4d30cdb948b67eb57c1c169
-  data.tar.gz: a3ba4f0c7e0a365cb084ce05ad9d904d8c2f32d9
+  metadata.gz: f41913654bc402d2a30d3c2345e0ac1fbd587ffe
+  data.tar.gz: a20bebaeb60c419708f83b078c8f5e61464788ec
 SHA512:
-  metadata.gz: f83cde3f3b6b2d45059cf3f164d908b4a35b08897589e7a171b31d072907e9b34b0667be9888bacc625ff533b2c4abb0b77c294c6b9802aa53ef6505e71933c5
-  data.tar.gz: 104ad9a0af48d17a0bef176f49d8e1c16d86d0f6e902fb98885a9678f8fc917889a6de18f5519a1b3cc834b5872323250ed30bafd57d5e588fef6e663347c653
+  metadata.gz: daed7260c5c3b320216186f6c10ed0468bf78a6c5038b8bd6a0d5521e61dc606088ba505feda784318e6cf9800b7dfb8414824db66e8950193df8a877f76db22
+  data.tar.gz: fbab02d4e41a802249bc5b30b1b87392392f5f4cba319c554e825d8bed79ae3bf26a5186d640219b7d0e2da5472b50a2c18f850f31e232e15ee3c15db04f39bb

data/CHANGELOG.md

@@ -1,9 +1,50 @@
 Changelog
 =========
 
+## [v1.9.0]
+
+### New Cisco Resources
+* EVPN Multisite
+  * evpn_multisite (@rahushen)
+  * evpn_stormcontrol (@rahushen)
+  * interface_evpn_multisite (@rahushen)
+
+* TRM
+  * evpn_multicast (@rahushen)
+  * ip_multicast (@rahushen)
+
+### Added
+* Extend vxlan_vtep with attributes:
+   * `multisite_border_gateway_interface`
+
+* Extend vxlan_vtep_vni with attributes:
+   * `multisite_ingress_replication`
+
+* Extend bgp_neighbor with attributes:
+   * `peer_type`
+
+* Extend bgp_neighbor_af with attributes:
+   * `rewrite_evpn_rt_asn`
+
+* Extend vrf_af with attributes:
+   * `route_target_both_auto_mvpn`
+   * `route_target_export_mvpn`
+   * `route_target_import_mvpn`
+
+* Extend feature with attributes:
+  * `ngmvpn_enable`
+  * `ngmvpn_disable`
+  * `ngmvpn_enabled?`
+
+### Changed
+
+### Removed
+
+### Issues Addressed
+
 ## [v1.8.0]
 
-#### Cisco Resources
+### New Cisco Resources
 * ObjectGroup
   * object_group (@saichint)
   * object_group_entry (@saichint)
@@ -513,6 +554,7 @@ Changelog
 [git-flow]: https://github.com/petervanderdoes/gitflow-avh
 [SimpleCov]: https://github.com/colszowka/simplecov
 
+[v1.9.0]: https://github.com/cisco/cisco-network-node-utils/compare/v1.8.0...v1.9.0
 [v1.8.0]: https://github.com/cisco/cisco-network-node-utils/compare/v1.7.0...v1.8.0
 [v1.7.0]: https://github.com/cisco/cisco-network-node-utils/compare/v1.6.0...v1.7.0
 [v1.6.0]: https://github.com/cisco/cisco-network-node-utils/compare/v1.5.0...v1.6.0

data/README.md

@@ -42,8 +42,8 @@ This CiscoNodeUtils gem release supports the following:
 
 Platform          | OS     | OS Version           |
 ------------------|--------|----------------------|
-Cisco Nexus N9k   | NX-OS  | 7.0(3)I2(1) and later
-Cisco Nexus N3k   | NX-OS  | 7.0(3)I2(1) and later
+Cisco Nexus N9k   | NX-OS  | 7.0(3)I2(5) and later
+Cisco Nexus N3k   | NX-OS  | 7.0(3)I2(5) and later
 Cisco Nexus N3K-F | NX-OS  | 7.0(3)F3(2) and later
 Cisco Nexus N5k   | NX-OS  | 7.3(0)N1(1) and later
 Cisco Nexus N6k   | NX-OS  | 7.3(0)N1(1) and later
@@ -91,7 +91,7 @@ An example configuration file (illustrating each of the above scenarios) is prov
 
 The `Client` class provides a low-level interface for communicating with the Cisco network node. It provides the base APIs `create`, `get`, and `set`.
 
-* `Cisco::Client::NXAPI` - client for communicating with NX-OS 7.0(3)I2(1) and later, using NX-API.
+* `Cisco::Client::NXAPI` - client for communicating with NX-OS 7.0(3)I2(5) and later, using NX-API.
 
 For a greater level of abstraction, the `Node` class is generally used, but the `Client` classes can be invoked directly if desired.
 
@@ -217,7 +217,7 @@ See [CHANGELOG](CHANGELOG.md) for a list of changes.
 ## <a name="license_info">License Information</a>
 
 
-Copyright (c) 2013-2017 Cisco and/or its affiliates.
+Copyright (c) 2013-2018 Cisco and/or its affiliates.
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

data/docs/README-maintainers.md

@@ -25,6 +25,7 @@ When we are considering publishing a new release, all of the following steps mus
 1. Run full minitest regression on [supported platforms.](https://github.com/cisco/cisco-network-node-utils#overview)
     * Fix All Bugs.
     * Make sure proper test case skips are in place for unsupported platforms.
+    * Make sure [yum_package.yaml](../tests/yum_package.yaml) is updated with all versions that need to be tested.
 
 1. Build gem and test it in combination with the latest released Puppet module (using Beaker and demo manifests) to make sure no backward compatibility issues have been introduced.
 

data/lib/cisco_node_utils/bgp_neighbor.rb

@@ -503,5 +503,25 @@ module Cisco
         fail KeyError
       end
     end
+
+    def default_peer_type
+      config_get_default('bgp_neighbor', 'peer_type')
+    end
+
+    def peer_type=(val)
+      if val == default_peer_type
+        @set_args[:state] = 'no'
+        @set_args[:peer_type] = ''
+      else
+        Feature.nv_overlay_evpn_enable
+        @set_args[:peer_type] = val
+        @set_args[:state] = ''
+      end
+      config_set('bgp_neighbor', 'peer_type', @set_args)
+    end
+
+    def peer_type
+      config_get('bgp_neighbor', 'peer_type', @get_args)
+    end
   end # class
 end # module

data/lib/cisco_node_utils/bgp_neighbor_af.rb

@@ -756,5 +756,25 @@ module Cisco
     def default_weight
       config_get_default('bgp_neighbor_af', 'weight')
     end
+
+    def rewrite_evpn_rt_asn
+      config_get('bgp_neighbor_af', 'rewrite_evpn_rt_asn', @get_args)
+    end
+
+    def rewrite_evpn_rt_asn=(state)
+      Feature.nv_overlay_evpn_enable if state
+      set_args_keys(state: (state ? '' : 'no'))
+      if @set_args[:state] == 'no'
+        unless rewrite_evpn_rt_asn == default_rewrite_evpn_rt_asn
+          config_set('bgp_neighbor_af', 'rewrite_evpn_rt_asn', @set_args)
+        end
+      else
+        config_set('bgp_neighbor_af', 'rewrite_evpn_rt_asn', @set_args)
+      end
+    end
+
+    def default_rewrite_evpn_rt_asn
+      config_get_default('bgp_neighbor_af', 'rewrite_evpn_rt_asn')
+    end
   end
 end

data/lib/cisco_node_utils/cmd_ref/bgp_neighbor.yaml

@@ -114,6 +114,13 @@ password_type:
     get_value: '/^password (\d+)/'
     default_value: 0
 
+peer_type:
+  _exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+  kind: string
+  get_value: '/^peer-type (\S+)$/'
+  set_value: '<state> peer-type <peer_type>'
+  default_value: ""
+
 remote_as:
   get_value: '/^remote-as (\d*?.?\d+?)$/'
   set_value: '<state> remote-as <remote_as>'

data/lib/cisco_node_utils/cmd_ref/bgp_neighbor_af.yaml

@@ -146,6 +146,13 @@ prefix_list_out:
   set_value: '<state> prefix-list <str> out'
   default_value: ''
 
+rewrite_evpn_rt_asn:
+  _exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+  kind: boolean
+  get_value: '/^rewrite-evpn-rt-asn$/'
+  set_value: '<state> rewrite-evpn-rt-asn'
+  default_value: false
+
 route_map_in:
   kind: string
   default_value: ''

data/lib/cisco_node_utils/cmd_ref/evpn_multicast.yaml

@@ -0,0 +1,12 @@
+# evpn_multicast.yaml
+---
+_exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+
+_template:
+  get_command: "show running-config | section advertise"
+
+multicast:
+  context: ~
+  get_value: '^advertise evpn multicast$'
+  set_value: "<state> advertise evpn multicast"
+  default_value: ''

data/lib/cisco_node_utils/cmd_ref/evpn_multisite.yaml

@@ -0,0 +1,18 @@
+# evpn_multisite.yaml
+---
+_exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+
+_template:
+  get_command: "show running-config | section multisite"
+
+delay_restore:
+  default_value: ""
+  get_context: ['/^evpn multisite border-gateway <multisiteid>$/']
+  get_value: '/^delay-restore\s+time\s+(\d+)$/'
+  set_context: ['evpn multisite border-gateway <multisiteid>']
+  set_value: "<state> delay-restore time <time>"
+
+multisite:
+  context: ~
+  get_value: 'evpn multisite border-gateway ([\d.]+)'
+  set_value: "<state> evpn multisite border-gateway <multisiteid>"

data/lib/cisco_node_utils/cmd_ref/evpn_stormcontrol.yaml

@@ -0,0 +1,18 @@
+# evpn_stormcontrol.yaml
+---
+_exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+
+_template:
+  get_command: "show running-config | section storm-control"
+
+broadcast:
+  get_value: 'evpn storm-control broadcast level ([\d.]+)'
+  set_value: "<state> evpn storm-control broadcast level <level>"
+
+multicast:
+  get_value: 'evpn storm-control multicast level ([\d.]+)'
+  set_value: "<state> evpn storm-control multicast level <level>"
+
+unicast:
+  get_value: 'evpn storm-control unicast level ([\d.]+)'
+  set_value: "<state> evpn storm-control unicast level <level>"

data/lib/cisco_node_utils/cmd_ref/feature.yaml

@@ -52,6 +52,13 @@ lacp:
   get_value: '/^feature lacp$/'
   set_value: "feature lacp"
 
+ngmvpn:
+  _exclude: [N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+  os_version: 'N9k:7.0.3.I7.1'
+  kind: boolean
+  get_value: '/^feature ngmvpn$/'
+  set_value: "<state> feature ngmvpn"
+
 nv_overlay:
   # N3k - native vxlan support in a future release
   _exclude: [N3k]

data/lib/cisco_node_utils/cmd_ref/interface_evpn_multisite.yaml

@@ -0,0 +1,17 @@
+# interface_evpn_multisite
+---
+_exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+
+_template:
+  get_command: "show running interface all"
+  context:
+    - "interface <interface>"
+
+all_interfaces:
+  multiple:
+  get_context: ~
+  get_value: '/^interface (.*)/'
+
+evpn_multisite:
+  get_value: '/^evpn multisite (\S+)$/'
+  set_value: "<state> evpn multisite <tracking>"

data/lib/cisco_node_utils/cmd_ref/ip_multicast.yaml

@@ -0,0 +1,18 @@
+# ip_multicast.yaml
+---
+_exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+
+_template:
+  get_command: "show running-config | section 'ip multicast'"
+
+overlay_distributed_dr:
+  context: ~
+  get_value: '^ip multicast overlay-distributed-dr$'
+  set_value: "<state> ip multicast overlay-distributed-dr"
+  default_value: false
+
+overlay_spt_only:
+  context: ~
+  get_value: '^ip multicast overlay-spt-only$'
+  set_value: "<state> ip multicast overlay-spt-only"
+  default_value: false

data/lib/cisco_node_utils/cmd_ref/vrf_af.yaml

@@ -52,6 +52,13 @@ route_target_both_auto_evpn:
   set_value: '<state> route-target both auto evpn'
   default_value: false
 
+route_target_both_auto_mvpn:
+  _exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+  kind: boolean
+  get_value: '/^route-target both auto mvpn$/'
+  set_value: '<state> route-target both auto mvpn'
+  default_value: false
+
 route_target_export:
   multiple: true
   default_value: []
@@ -73,6 +80,13 @@ route_target_export_evpn:
   set_value: '<state> route-target export <community> evpn'
   default_value: []
 
+route_target_export_mvpn:
+  _exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+  multiple: true
+  get_value: '/^route-target export (\S+) mvpn$/'
+  set_value: '<state> route-target export <community> mvpn'
+  default_value: []
+
 route_target_export_stitching:
   _exclude: [nexus]
   multiple: true
@@ -105,6 +119,13 @@ route_target_import_evpn:
   set_value: '<state> route-target import <community> evpn'
   default_value: []
 
+route_target_import_mvpn:
+  _exclude: [ios_xr, N3k, N3k-F, N5k, N6k, N7k, N9k-F]
+  multiple: true
+  get_value: '/^route-target import (\S+) mvpn$/'
+  set_value: '<state> route-target import <community> mvpn'
+  default_value: []
+
 route_target_import_stitching:
   _exclude: [nexus]
   multiple: true

data/lib/cisco_node_utils/cmd_ref/vxlan_vtep.yaml

@@ -39,6 +39,12 @@ mt_lite_support:
     # this feature is always off on these platforms and cannot be changed
     default_only: false
 
+multisite_bg_intf:
+    _exclude: [N3k-F, N5k, N6k, N7k, N9k-F]
+    get_value: '/^multisite border\-gateway interface (\S+)$/'
+    set_value: '<state> multisite border-gateway interface <lpbk_intf>'
+    default_value: ''
+
 shutdown:
   kind: boolean
   get_value: '/^no shutdown$/'

data/lib/cisco_node_utils/cmd_ref/vxlan_vtep_vni.yaml

@@ -27,6 +27,13 @@ multicast_group:
   set_value: '<state> mcast-group <ip_start> <ip_end>'
   default_value: ''
 
+multisite_ingress_replication:
+  _exclude: [N3k-F, N5k, N6k, N7k, N9k-F]
+  kind: boolean
+  get_value: '/^multisite ingress-replication$/'
+  set_value: '<state> multisite ingress-replication'
+  default_value: false
+
 peer_list:
   _exclude: [N5k, N6k, N7k]
   multiple:

data/lib/cisco_node_utils/evpn_multicast.rb

@@ -0,0 +1,66 @@
+# January 2018, Rahul Shenoy
+#
+# Copyright (c) 2018 Cisco and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative 'cisco_cmn_utils'
+require_relative 'node_util'
+require_relative 'feature'
+
+module Cisco
+  # node_utils class for evpn_multisite
+  class EvpnMulticast < NodeUtil
+    def initialize
+      @get_args = @set_args = {}
+      create
+    end
+
+    def create
+      return unless multicast == default_multicast
+      Feature.ngmvpn_enable
+      config_set('feature', 'nv_overlay', state: '')
+      @set_args[:state] = ''
+      config_set('evpn_multicast', 'multicast', @set_args)
+    end
+
+    def destroy
+      @set_args[:state] = 'no'
+      config_set('evpn_multicast', 'multicast', @set_args)
+    end
+
+    def self.multicast
+      config_get('evpn_multicast', 'multicast')
+    end
+
+    def multicast
+      config_get('evpn_multicast', 'multicast')
+    end
+
+    def multicast=(bool)
+      fail TypeError unless [true, false].include?(bool)
+      @set_args[:state] = bool ? '' : 'no'
+      if @set_args[:state] == 'no'
+        unless multicast == default_multicast
+          config_set('evpn_multicast', 'multicast', @set_args)
+        end
+      else
+        config_set('evpn_multicast', 'multicast', @set_args)
+      end
+    end
+
+    def default_multicast
+      config_get_default('evpn_multicast', 'multicast')
+    end
+  end
+end

data/lib/cisco_node_utils/evpn_multisite.rb

@@ -0,0 +1,96 @@
+# October 2017, Rahul Shenoy
+#
+# Copyright (c) 2017 Cisco and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require_relative 'cisco_cmn_utils'
+require_relative 'node_util'
+require_relative 'feature'
+
+module Cisco
+  # node_utils class for evpn_multisite
+  class EvpnMultisite < NodeUtil
+    attr_reader :multisiteid, :time
+
+    def initialize(multisiteid, instantiate=true)
+      err_msg = "multisiteid must be either a 'String' or an" \
+                " 'Integer' object"
+      fail ArgumentError, err_msg unless multisiteid.is_a?(Integer) ||
+                                         multisiteid.is_a?(String)
+      @multisiteid = multisiteid.to_i
+      @get_args = @set_args = { multisiteid: @multisiteid }
+      create if instantiate
+    end
+
+    def create
+      # There is an issue with EX platform using
+      # Feature.nv_overlay_enable generating error code '400'
+      # Using config_set for enabling nv overlay
+      config_set('feature', 'nv_overlay', state: '')
+      sleep 1
+      @set_args[:state] = ''
+      config_set('evpn_multisite', 'multisite', @set_args)
+    end
+
+    def destroy
+      @set_args[:state] = 'no'
+      # HACK: set time to a dummy value
+      @set_args[:time] = 30
+      config_set('evpn_multisite', 'delay_restore', @set_args)
+      config_set('evpn_multisite', 'multisite', @set_args)
+    end
+
+    def self.multisite
+      nu_obj = nil
+      ms_id = config_get('evpn_multisite', 'multisite')
+      nu_obj = EvpnMultisite.new(ms_id, false) if ms_id
+      nu_obj
+    end
+
+    def multisite
+      config_get('evpn_multisite', 'multisite')
+    end
+
+    def multisite=(multisiteid)
+      err_msg = "multisiteid must be either a 'String' or an" \
+                " 'Integer' object"
+      fail ArgumentError, err_msg unless multisiteid.is_a?(Integer) ||
+                                         multisiteid.is_a?(String)
+      @multisiteid = multisiteid.to_i
+      @set_args[:multisiteid] = @multisiteid
+      config_set('evpn_multisite', 'multisite', @set_args)
+    end
+
+    def delay_restore
+      config_get('evpn_multisite', 'delay_restore', @get_args)
+    end
+
+    def delay_restore=(time)
+      # HACK: set a dummy time value when removing the property
+      dummy_time = 30
+      if time == default_delay_restore
+        @set_args[:state] = 'no'
+        @set_args[:time] = dummy_time
+      else
+        @set_args[:time] = time
+        @set_args[:state] = '' unless @set_args[:state]
+      end
+      config_set('evpn_multisite', 'delay_restore', @set_args)
+    end
+
+    def default_delay_restore
+      config_get_default('evpn_multisite', 'delay_restore')
+    end
+  end
+end