cisco_node_utils_mgx 2.1.0.1

data/tests/test_evpn_multisite.rb

@@ -0,0 +1,70 @@
+# Evpn Multisite Unit Tests
+#
+# Rahul Shenoy, October, 2017
+#
+# 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 'ciscotest'
+require_relative '../lib/cisco_node_utils/evpn_multisite'
+
+# TestEvpnMultisite - Minitest for EvpnMultisite class
+class TestEvpnMultisite < CiscoTestCase
+  @skip_unless_supported = 'evpn_multisite'
+
+  def setup
+    # Disable feature nv overlay before each test to
+    # ensure we are starting with a clean slate for each test.
+    super
+    skip("#{node.product_id} doesn't support this feature") unless
+      node.product_id[/N9K.*EX/]
+    config('no feature nv overlay')
+  end
+
+  def test_create_and_destroy
+    ms = EvpnMultisite.new(100)
+    ms_id = ms.multisite
+    assert_equal('100', ms_id,
+                 'Error: failed to create multisite border-gateway 100')
+    ms.destroy
+    ms_id = ms.multisite
+    assert_nil(ms_id, 'Error: failed to destroy multisite border-gateway 100')
+  end
+
+  def test_delay_restore
+    ms = EvpnMultisite.new(100)
+    ms.delay_restore = 31
+    assert_equal('31', ms.delay_restore,
+                 'multisite border-gateway delay_restore should be 31')
+    ms.delay_restore = 1000
+    assert_equal('1000', ms.delay_restore,
+                 'multisite border-gateway delay_restore should be 1000')
+    ms.destroy
+  end
+
+  def test_update_multisiteid
+    ms = EvpnMultisite.new(100)
+    ms.delay_restore = 50
+    assert_equal('100', ms.multisite,
+                 'Error: failed to create multisite border-gateway 100')
+    assert_equal('50', ms.delay_restore,
+                 'multisite border-gateway delay_restore should be 50')
+    ms.multisite = 200
+    assert_equal('200', ms.multisite,
+                 'Error: failed to create multisite border-gateway 200')
+    assert_equal('50', ms.delay_restore,
+                 'multisite border-gateway delay_restore should be 50')
+    ms.destroy
+  end
+end

data/tests/test_evpn_stormcontrol.rb

@@ -0,0 +1,56 @@
+# Evpn Stormcontrol Unit Tests
+#
+# Rahul Shenoy, October, 2017
+#
+# 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 'ciscotest'
+require_relative '../lib/cisco_node_utils/evpn_stormcontrol'
+
+# TestEvpnStormcontrol - Minitest for EvpnStormcontrol class
+class TestEvpnStormcontrol < CiscoTestCase
+  @skip_unless_supported = 'evpn_stormcontrol'
+
+  def setup
+    # Ensure we are starting with a clean slate for each test.
+    super
+    skip("#{node.product_id} doesn't support this feature") unless
+      node.product_id[/N9K.*EX/]
+    config('no evpn storm-control broadcast level 50')
+    config('no evpn storm-control multicast level 50')
+    config('no evpn storm-control unicast level 50')
+  end
+
+  def test_create_and_destroy
+    sc = EvpnStormcontrol.new('broadcast', 50)
+    sc_level = sc.level
+    assert_equal('50', sc_level,
+                 'Error: failed to configure evpn storm-control broadcast ' \
+                 'level 50')
+    sc.destroy
+    sc_level = sc.level
+    assert_nil(sc_level, 'Error: failed to destroy storm-control config')
+  end
+
+  def test_update_level
+    sc = EvpnStormcontrol.new('multicast', 50)
+    assert_equal('50', sc.level,
+                 'Error: multicast storm-control level should be 50')
+    sc.level = 51
+    assert_equal('51', sc.level,
+                 'Error: failed to create multisite border-gateway 200')
+    sc.destroy
+  end
+end

data/tests/test_evpn_vni.rb

@@ -0,0 +1,131 @@
+# Evpn Vni Unit Tests
+#
+# Andi Shen, December, 2015
+#
+# Copyright (c) 2015-2016 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 'ciscotest'
+require_relative '../lib/cisco_node_utils/evpn_vni'
+
+# TestEvpnVni - Minitest for EvpnVni class
+class TestEvpnVni < CiscoTestCase
+  @skip_unless_supported = 'evpn_vni'
+
+  def setup
+    # Disable feature bgp and no overlay evpn before each test to
+    # ensure we are starting with a clean slate for each test.
+    super
+    config('no feature bgp')
+
+    # Some platforms complain when nv overlay is not configured
+    config_no_warn('no nv overlay evpn')
+
+    # Some platforms remove the 'evpn' command when 'no nv overlay evpn'
+    # is processed, while others must remove it explicitly.
+    config_no_warn('no evpn')
+
+  rescue RuntimeError => e
+    hardware_supports_feature?(e.message)
+  end
+
+  def test_create_and_destroy
+    vni = EvpnVni.new(4096)
+    vni_list = EvpnVni.vnis
+    assert(vni_list.key?('4096'), 'Error: failed to create evpn vni 4096')
+
+    vni.destroy
+    vni_list = EvpnVni.vnis
+    refute(vni_list.key?('4096'), 'Error: failed to destroy evpn vni 4096')
+
+  rescue RuntimeError => e
+    hardware_supports_feature?(e.message)
+  end
+
+  def test_route_distinguisher
+    vni = EvpnVni.new(4096)
+    vni.route_distinguisher = 'auto'
+    assert_equal('auto', vni.route_distinguisher,
+                 "vni route_distinguisher should be set to 'auto'")
+    vni.route_distinguisher = '1:1'
+    assert_equal('1:1', vni.route_distinguisher,
+                 "vni route_distinguisher should be set to '1:1'")
+    vni.route_distinguisher = vni.default_route_distinguisher
+    assert_empty(vni.route_distinguisher,
+                 'vni route_distinguisher should *NOT* be configured')
+    vni.destroy
+
+  rescue RuntimeError => e
+    hardware_supports_feature?(e.message)
+  end
+
+  # test route_target
+  def test_route_target
+    vni = EvpnVni.new(4096)
+    opts = [:both, :import, :export]
+
+    # 'route_target_both' has limited support with I2.5 and later images.
+    # The Puppet README states:
+    # Caveat: The route_target_both property is discouraged due to the
+    # inconsistent behavior of the property across Nexus platforms and image
+    # versions. The 'both' keyword has a transformative behavior on some
+    # platforms/versions in which it creates two cli configurations: one for
+    # import targets, a second for export targets, while the 'both' command
+    # itself may not appear at all. When the 'both' keyword does not appear
+    # in the configuration it causes an idempotency problem for puppet. For
+    # this reason it is recommended to use explicit 'route_target_export' and
+    # 'route_target_import' properties instead of route_target_both.
+    opts.delete(:both)
+
+    # Master list of communities to test against
+    master = ['1.2.3.4:55', '2:2', '55:33', 'auto']
+
+    # Test 1: both/import/export when no commands are present. Each target
+    should = master.clone
+    route_target_tester(vni, opts, should, 'Test 1')
+
+    # Test 2: remove half of the entries
+    should = ['2:2', 'auto']
+    route_target_tester(vni, opts, should, 'Test 2')
+
+    # Test 3: restore the removed entries
+    should = master.clone
+    route_target_tester(vni, opts, should, 'Test 3')
+
+    # Test 4: 'default'
+    should = vni.default_route_target_import
+    route_target_tester(vni, opts, should, 'Test 4')
+
+    vni .destroy
+
+  rescue RuntimeError => e
+    hardware_supports_feature?(e.message)
+  end
+
+  def route_target_tester(vni, opts, should, test_id)
+    # First configure all four property types
+    opts.each do |opt|
+      # non-evpn
+      vni.send("route_target_#{opt}=", should)
+    end
+
+    # Now check the results
+    opts.each do |opt|
+      # non-evpn
+      result = vni.send("route_target_#{opt}")
+      assert_equal(should, result,
+                   "#{test_id} : route_target_#{opt}")
+    end
+  end
+end

data/tests/test_fabricpath_global.rb

@@ -0,0 +1,246 @@
+# Copyright (c) 2014-2016 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 'ciscotest'
+require_relative '../lib/cisco_node_utils/cisco_cmn_utils'
+require_relative '../lib/cisco_node_utils/fabricpath_global'
+require_relative '../lib/cisco_node_utils/interface'
+require_relative '../lib/cisco_node_utils/platform'
+
+include Cisco
+
+# TestFabricpathGlobal - Minitest for Fabricpath Global node utils
+class TestFabricpathGlobal < CiscoTestCase
+  @skip_unless_supported = 'fabricpath'
+  @@pre_clean_needed = true # rubocop:disable Style/ClassVars
+
+  def setup
+    super
+    vdc_limit_f3_no_intf_needed(:set)
+    return unless @@pre_clean_needed
+    config_no_warn('no nv overlay evpn ; no feature nv overlay')
+    remove_fabricpath_globals
+    @@pre_clean_needed = false # rubocop:disable Style/ClassVars
+  end
+
+  def teardown
+    remove_fabricpath_globals
+    if first_or_last_teardown
+      vdc_limit_f3_no_intf_needed(:clear)
+      config_no_warn('no feature-set fabricpath')
+    end
+    super
+  end
+
+  def remove_fabricpath_globals
+    fg = FabricpathGlobal.globals
+    fg.each { |_key, elem| elem.destroy } unless fg.empty?
+  end
+
+  def test_create_destroy
+    assert_empty(FabricpathGlobal.globals)
+
+    # create
+    fg = FabricpathGlobal.new('default')
+    assert_equal('default', fg.name)
+    assert_equal(:enabled, FabricpathGlobal.fabricpath_feature)
+    refute_empty(FabricpathGlobal.globals)
+
+    # destroy
+    fg.destroy
+    assert_empty(FabricpathGlobal.globals)
+  end
+
+  def test_aggregate_multicast_routes
+    fg = FabricpathGlobal.new('default')
+    if validate_property_excluded?('fabricpath', 'aggregate_multicast_routes')
+      assert_raises(Cisco::UnsupportedError) do
+        fg.aggregate_multicast_routes = true
+      end
+      return
+    end
+
+    fg = FabricpathGlobal.new('default')
+    fg.aggregate_multicast_routes = true
+    assert(fg.aggregate_multicast_routes,
+           'aggregate_multicast_routes: Expected: true')
+
+    fg.aggregate_multicast_routes = false
+    refute(fg.aggregate_multicast_routes,
+           'aggregate_multicast_routes: Expected: false')
+  end
+
+  def test_allocate_delay
+    fg = FabricpathGlobal.new('default')
+    assert_equal(fg.default_allocate_delay, fg.allocate_delay)
+
+    fg.allocate_delay = 20
+    assert_equal(20, fg.allocate_delay)
+  end
+
+  def test_graceful_merge
+    fg = FabricpathGlobal.new('default')
+    assert_equal(fg.default_graceful_merge, fg.graceful_merge)
+
+    fg.graceful_merge = :disable
+    assert_equal(:disable, fg.graceful_merge)
+  end
+
+  def test_linkup_delay_all
+    fg = FabricpathGlobal.new('default')
+    assert_equal(fg.default_linkup_delay, fg.linkup_delay)
+
+    fg.linkup_delay = 25
+    assert_equal(25, fg.linkup_delay)
+
+    if validate_property_excluded?('fabricpath', 'linkup_delay_always')
+      assert_raises(Cisco::UnsupportedError) { fg.linkup_delay_always = true }
+    else
+      assert_equal(fg.default_linkup_delay_always, fg.linkup_delay_always)
+      fg.linkup_delay_always = true
+      assert(fg.linkup_delay_always, 'linkup_delay_always: Expected: true')
+      fg.linkup_delay_always = false
+      refute(fg.linkup_delay_always, 'linkup_delay_always: Expected: false')
+    end
+
+    if validate_property_excluded?('fabricpath', 'linkup_delay_enable')
+      assert_raises(Cisco::UnsupportedError) { fg.linkup_delay_enable = true }
+      return
+    end
+
+    assert_equal(fg.default_linkup_delay_enable, fg.linkup_delay_enable)
+    fg.linkup_delay_enable = true
+    assert(fg.linkup_delay_enable, 'linkup_delay_enable: Expected: true')
+    fg.linkup_delay_enable = false
+    refute(fg.linkup_delay_enable, 'linkup_delay_enable: Expected: false')
+  end
+
+  def test_loadbalance_algorithm
+    fg = FabricpathGlobal.new('default')
+    assert_equal(fg.default_loadbalance_algorithm, fg.loadbalance_algorithm)
+
+    fg.loadbalance_algorithm = 'source'
+    assert_equal('source', fg.loadbalance_algorithm)
+    if validate_property_excluded?('fabricpath',
+                                   'loadbalance_algorithm_symmetric_support')
+      assert_nil(fg.loadbalance_algorithm_symmetric_support)
+      return
+    end
+    fg.loadbalance_algorithm = 'symmetric'
+    assert_equal('symmetric', fg.loadbalance_algorithm)
+  end
+
+  def test_loadbalance_multicast
+    # loadbalance_multicast= is a custom setter that takes 2 args:
+    #   rotate, has_vlan
+    fg = FabricpathGlobal.new('default')
+    if validate_property_excluded?('fabricpath',
+                                   'loadbalance_multicast_set')
+      assert_raises(Cisco::UnsupportedError) do
+        (fg.send(:loadbalance_multicast=, 0, 0))
+      end
+      return
+    end
+
+    # default_loadbalance_multicast_rotate: n/a
+    assert(fg.loadbalance_multicast_has_vlan,
+           'loadbalance_multicast_has_vlan: Expected: true')
+
+    fg.send(:loadbalance_multicast=, 3, false)
+    assert_equal(3, fg.loadbalance_multicast_rotate)
+    refute(fg.loadbalance_multicast_has_vlan,
+           'loadbalance_multicast_has_vlan: Expected: false')
+  end
+
+  def test_loadbalance_unicast
+    # loadbalance_unicast= is a custom setter that takes up to 3 args:
+    #   layer, rotate, has_vlan (rotate is not supported on some plats)
+
+    fg = FabricpathGlobal.new('default')
+    assert_equal(fg.default_loadbalance_unicast_layer,
+                 fg.loadbalance_unicast_layer)
+
+    # default_loadbalance_unicast_rotate: n/a
+    assert_equal(fg.default_loadbalance_unicast_has_vlan,
+                 fg.loadbalance_unicast_has_vlan)
+
+    fg.send(:loadbalance_unicast=, 'layer4', 3, false)
+    assert_equal('layer4', fg.loadbalance_unicast_layer)
+    unless validate_property_excluded?('fabricpath',
+                                       'loadbalance_unicast_rotate')
+      assert_equal(3, fg.loadbalance_unicast_rotate)
+    end
+    refute(fg.loadbalance_unicast_has_vlan,
+           'loadbalance_unicast_has_vlan: Expected: false')
+  end
+
+  def test_mode
+    fg = FabricpathGlobal.new('default')
+    assert_equal(fg.default_mode, fg.mode)
+
+    fg.mode = 'transit'
+    assert_equal('transit', fg.mode)
+    fg.mode = 'normal'
+    assert_equal('normal', fg.mode)
+  end
+
+  def test_switch_id
+    fg = FabricpathGlobal.new('default')
+    # auto_id = fg.switch_id
+    # switch_id does not have a default
+    fg.switch_id = 100
+    assert_equal(100, fg.switch_id)
+  end
+
+  def test_transition_delay
+    fg = FabricpathGlobal.new('default')
+    assert_equal(fg.default_transition_delay, fg.transition_delay)
+
+    fg.transition_delay = 20
+    assert_equal(20, fg.transition_delay)
+  end
+
+  def test_ttl_multicast
+    fg = FabricpathGlobal.new('default')
+    if validate_property_excluded?('fabricpath', 'ttl_multicast')
+      assert_raises(Cisco::UnsupportedError) { fg.ttl_multicast = 40 }
+      return
+    end
+
+    assert_equal(fg.default_ttl_multicast, fg.ttl_multicast)
+    fg.ttl_multicast = 16
+    assert_equal(16, fg.ttl_multicast)
+  end
+
+  def test_ttl_unicast
+    fg = FabricpathGlobal.new('default')
+    if validate_property_excluded?('fabricpath', 'ttl_unicast')
+      assert_raises(Cisco::UnsupportedError) { fg.ttl_unicast = 40 }
+      return
+    end
+    assert_equal(fg.default_ttl_unicast, fg.ttl_unicast)
+    fg.ttl_unicast = 40
+    assert_equal(40, fg.ttl_unicast)
+  end
+
+  def test_interface_switchport_mode
+    i = Interface.new(interfaces[0])
+    i.switchport_mode = :fabricpath
+    assert_equal(:fabricpath, i.switchport_mode)
+
+    i.switchport_mode = :trunk
+    assert_equal(:trunk, i.switchport_mode)
+    config("default interface #{interfaces[0]}")
+  end
+end

data/tests/test_fabricpath_topology.rb

@@ -0,0 +1,77 @@
+# Copyright (c) 2014-2016 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 'ciscotest'
+require_relative '../lib/cisco_node_utils/cisco_cmn_utils'
+require_relative '../lib/cisco_node_utils/fabricpath_topology'
+
+include Cisco
+
+# TestFabricpathTopo - Minitest for Fabricpath Topo node utils
+class TestFabricpathTopo < CiscoTestCase
+  @skip_unless_supported = 'fabricpath_topology'
+
+  def setup
+    # setup runs at the beginning of each test
+    super
+    skip("Test not supported on #{node.product_id}") if
+      cmd_ref.lookup('fabricpath', 'feature').default_value.nil?
+    no_feature_fabricpath
+  end
+
+  def teardown
+    # teardown runs at the end of each test
+    no_feature_fabricpath
+    super
+  end
+
+  def no_feature_fabricpath
+    # Turn the feature off for a clean test.
+    config_no_warn('no feature-set fabricpath')
+  end
+
+  # TESTS
+
+  def test_topo_create
+    @topo = FabricpathTopo.new('1')
+    @topo.topo_name = 'Topo-1'
+    assert_equal('Topo-1', @topo.topo_name,
+                 "Topo name not set correctly #{@topo.topo_name}")
+    assert_equal(:enabled, @topo.fabricpath_feature,
+                 'Fabricpath feature should have been enabled')
+    topos = FabricpathTopo.topos
+    assert_equal(1, topos.length,
+                 'Number of Topos should be 1')
+  end
+
+  def test_topo_destroy
+    # create and test again
+    @topo = FabricpathTopo.new('2')
+    @topo.destroy
+    # now it should be wiped out
+    topos = FabricpathTopo.topos
+    assert_equal(0, topos.length,
+                 'Number of Topos should be 0 (only default)')
+  end
+
+  def test_member_vlans
+    @topo = FabricpathTopo.new('25')
+    @topo.topo_name = 'Topo-25'
+    @topo.member_vlans = '2-10, 100, 500'
+    topo25_vlans = @topo.member_vlans
+    # puts "Topo #{@topo.topo_name} member vlans #{topo25_vlans}"
+    assert_equal('2-10,100,500', topo25_vlans,
+                 'Topo 25 not getting set with member vlans')
+  end
+end