cisco_node_utils 1.1.0 → 1.2.0

data/tests/test_interface_channel_group.rb

@@ -0,0 +1,74 @@
+# 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/interface_channel_group'
+
+# TestInterface - Minitest for general functionality of the Interface class.
+class TestInterfaceChannelGroup < CiscoTestCase
+  @@clean = false # rubocop:disable Style/ClassVars
+  def setup
+    super
+    @intf = InterfaceChannelGroup.new(interfaces[1])
+
+    # Only pre-clean interface on initial setup
+    config("default interface #{@intf}") unless @@clean
+    @@clean = true # rubocop:disable Style/ClassVars
+  end
+
+  def teardown
+    config("default interface #{@intf}")
+  end
+
+  def test_channel_group
+    i = @intf
+    group = 200
+    i.channel_group = group
+    assert_equal(group, i.channel_group)
+
+    group = 201
+    i.channel_group = group
+    assert_equal(group, i.channel_group)
+
+    group = i.default_channel_group
+    i.channel_group = group
+    assert_equal(group, i.channel_group)
+  end
+
+  def test_description
+    i = @intf
+    desc = 'test desc'
+    i.description = desc
+    assert_equal(desc, i.description)
+
+    desc = 'test desc changed'
+    i.description = desc
+    assert_equal(desc, i.description)
+
+    desc = i.default_description
+    i.description = desc
+    assert_equal(desc, i.description)
+  end
+
+  def test_shutdown
+    i = @intf
+    i.shutdown = true
+    assert(i.shutdown)
+    i.shutdown = false
+    refute(i.shutdown)
+
+    i.shutdown = i.default_shutdown
+    assert(i.shutdown)
+  end
+end

data/tests/test_interface_ospf.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2014-2015 Cisco and/or its affiliates.
+# 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.
@@ -40,7 +40,12 @@ class TestInterfaceOspf < CiscoTestCase
   end
 
   def show_cmd(name)
-    "show run interface #{name} all | no-more"
+    case name
+    when /ort-channel/
+      "show run interface #{name} | no-more"
+    else
+      "show run interface #{name} all | no-more"
+    end
   end
 
   def create_routerospf(ospfname='ospfTest')
@@ -495,14 +500,14 @@ class TestInterfaceOspf < CiscoTestCase
     assert_show_match(pattern: pattern,
                       msg:     'Error: message digest enable missing in CLI')
     assert(interface.message_digest,
-           'Error: message digest get value mismatch')
+           'Error: message digest is false but should be true')
 
     # get default and set
     interface.message_digest = interface.default_message_digest
     refute_show_match(pattern: pattern,
                       msg:     'Error: default message digest set failed')
     refute(interface.message_digest,
-           'Error: message digest get value mismatch')
+           'Error: message digest is true but should be false (default)')
   end
 
   def test_interfaceospf_message_digest_key

data/tests/test_interface_portchannel.rb

@@ -0,0 +1,105 @@
+# 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/interface'
+require_relative '../lib/cisco_node_utils/interface_portchannel'
+
+# TestX__CLASS_NAME__X - Minitest for X__CLASS_NAME__X node utility class
+class TestInterfacePortChannel < CiscoTestCase
+  # TESTS
+
+  DEFAULT_NAME = 'port-channel134'
+
+  def setup
+    super
+    config "no interface #{DEFAULT_NAME}"
+  end
+
+  def teardown
+    config "no interface #{DEFAULT_NAME}"
+    super
+  end
+
+  def n6k_platform?
+    /N(5|6)/ =~ node.product_id
+  end
+
+  def create_port_channel(ifname=DEFAULT_NAME)
+    InterfacePortChannel.new(ifname)
+  end
+
+  def test_get_set_port_hash_distribution
+    skip('Platform does not support this property') if n6k_platform?
+    interface = create_port_channel
+    interface.port_hash_distribution = 'adaptive'
+    assert_equal('adaptive', interface.port_hash_distribution)
+    interface.port_hash_distribution = 'fixed'
+    assert_equal('fixed', interface.port_hash_distribution)
+    interface.port_hash_distribution =
+      interface.default_port_hash_distribution
+    assert_equal(interface.default_port_hash_distribution,
+                 interface.port_hash_distribution)
+  end
+
+  def test_get_set_lacp_graceful_convergence
+    interface = create_port_channel
+    interface.lacp_graceful_convergence = false
+    assert_equal(false, interface.lacp_graceful_convergence)
+    interface.lacp_graceful_convergence =
+      interface.default_lacp_graceful_convergence
+    assert_equal(interface.default_lacp_graceful_convergence,
+                 interface.lacp_graceful_convergence)
+  end
+
+  def test_get_set_lacp_min_links
+    interface = create_port_channel
+    interface.lacp_min_links = 5
+    assert_equal(5, interface.lacp_min_links)
+    interface.lacp_min_links = interface.default_lacp_min_links
+    assert_equal(interface.default_lacp_min_links,
+                 interface.lacp_min_links)
+  end
+
+  def test_get_set_lacp_max_bundle
+    interface = create_port_channel
+    interface.lacp_max_bundle = 10
+    assert_equal(10, interface.lacp_max_bundle)
+    interface.lacp_max_bundle =
+      interface.default_lacp_max_bundle
+    assert_equal(interface.default_lacp_max_bundle,
+                 interface.lacp_max_bundle)
+  end
+
+  def test_get_set_lacp_suspend_individual
+    interface = create_port_channel
+    interface.lacp_suspend_individual = false
+    assert_equal(false, interface.lacp_suspend_individual)
+    interface.lacp_suspend_individual =
+      interface.default_lacp_suspend_individual
+    assert_equal(interface.default_lacp_suspend_individual,
+                 interface.lacp_suspend_individual)
+  end
+
+  def test_get_set_port_load_defer
+    skip('Platform does not support this property') if n6k_platform?
+    interface = create_port_channel
+    interface.port_load_defer = true
+    assert_equal(true, interface.port_load_defer)
+    interface.port_load_defer =
+      interface.default_port_load_defer
+    assert_equal(interface.default_port_load_defer,
+                 interface.port_load_defer)
+  end
+end

data/tests/test_interface_service_vni.rb

@@ -0,0 +1,232 @@
+# Copyright (c) 2013-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/interface'
+require_relative '../lib/cisco_node_utils/interface_service_vni'
+require_relative '../lib/cisco_node_utils/vdc'
+
+include Cisco
+
+# TestInterfaceServiceVni - Minitest for the InterfaceServiceVni class.
+#
+# Example cli tested by this minitest:
+#
+#  encapsulation profile vni vni_500_5000
+#    dot1q 500  vni 5000
+#  interface Ethernet9/1
+#    service instance 5 vni
+#      encapsulation profile vni_500_5000 default
+#      shutdown
+#    service instance 6 vni
+#      encapsulation profile vni_600_6000 default
+#
+class TestInterfaceServiceVni < CiscoTestCase
+  def setup
+    super
+  end
+
+  def teardown
+    # Reset the vdc module type back to default
+    v = Vdc.new('default')
+    v.limit_resource_module_type = '' if v.limit_resource_module_type == 'f3'
+  end
+
+  def compatible_interface?
+    # MT-full tests require a specific linecard; either because they need a
+    # compatible interface or simply to enable the features. Either way
+    # we will provide an appropriate interface name if the linecard is present.
+    # Example 'show mod' output to match against:
+    #   '9  12  10/40 Gbps Ethernet Module  N7K-F312FQ-25 ok'
+    sh_mod = @device.cmd("sh mod | i '^[0-9]+.*N7K-F3'")[/^(\d+)\s.*N7K-F3/]
+    slot = sh_mod.nil? ? nil : Regexp.last_match[1]
+    skip('Unable to find compatible interface in chassis') if slot.nil?
+
+    "ethernet#{slot}/1"
+  end
+
+  def mt_full_env_setup
+    skip('Platform does not support MT-full') unless Vni.mt_full_support
+    intf = compatible_interface?
+    v = Vdc.new('default')
+    v.limit_resource_module_type = 'f3' unless
+      v.limit_resource_module_type == 'f3'
+    config("default int #{intf}")
+    intf
+  end
+
+  def global_setup
+    # Reset feature to clean up switch
+    config('no feature vni', 'feature vni')
+
+    # Create a global encap config
+    config('encapsulation profile vni vni_500_5000', 'dot1q 500  vni 5000',
+           'encapsulation profile vni vni_600_6000', 'dot1q 600  vni 6000',
+           'encapsulation profile vni vni_700_7000', 'dot1q 700  vni 7000',
+           'encapsulation profile vni vni_800_8000', 'dot1q 800  vni 8000')
+
+    # Configure a bridge-domain
+    config('system bridge-domain 100-113', 'bridge-domain 100')
+  end
+
+  def test_create_destroy
+    # This property has several dependencies:
+    #  - VDC support
+    #  - Specific linecard (F3 or newer)
+    #  - Bridge Domain Configuration
+    #  - Feature vni
+
+    intf = mt_full_env_setup
+    global_setup
+
+    # TEST Create / Destroy and svc_vni_ids hash builder
+    i5 = InterfaceServiceVni.new(intf, 5)
+    assert_equal(1, InterfaceServiceVni.svc_vni_ids[intf].count)
+    i6 = InterfaceServiceVni.new(intf, 6)
+    i7 = InterfaceServiceVni.new(intf, 7)
+    assert_equal(3, InterfaceServiceVni.svc_vni_ids[intf].count)
+    i6.destroy
+    assert_equal(2, InterfaceServiceVni.svc_vni_ids[intf].count)
+    i5.destroy
+    i7.destroy
+  end
+
+  def test_shutdown
+    intf = mt_full_env_setup
+    global_setup
+
+    i5 = InterfaceServiceVni.new(intf, 5)
+    # Test shutdown
+    i5.shutdown = false
+    refute(i5.shutdown)
+    i5.shutdown = true
+    assert(i5.shutdown)
+    i5.shutdown = false
+    refute(i5.shutdown)
+    i5.shutdown = i5.default_shutdown
+    assert(i5.shutdown)
+  end
+
+  def test_encapsulation_profile_vni
+    intf = mt_full_env_setup
+    global_setup
+
+    i5 = InterfaceServiceVni.new(intf, 5)
+
+    # Test removal when profile not present
+    i5.encapsulation_profile_vni = ''
+    assert_empty(i5.encapsulation_profile_vni)
+
+    # Add one
+    i5.encapsulation_profile_vni = 'vni_500_5000'
+    assert_equal('vni_500_5000', i5.encapsulation_profile_vni)
+
+    # Change it
+    i5.encapsulation_profile_vni = 'vni_700_7000'
+    assert_equal('vni_700_7000', i5.encapsulation_profile_vni)
+
+    # Test default when profile present
+    i5.encapsulation_profile_vni = 'vni_700_7000'
+    i5.encapsulation_profile_vni = i5.default_encapsulation_profile_vni
+    assert_equal(i5.default_encapsulation_profile_vni,
+                 i5.encapsulation_profile_vni)
+  end
+
+  # interface vlan_mapping is not technically part of the interface service
+  # but it shares most of the same dependencies so it is tested here instead
+  # of test_interface.rb
+  def test_vlan_mapping
+    # This test covers two properties:
+    #  vlan_mapping & vlan_mapping_enabled
+    #
+    # This property has several dependencies:
+    #  - VDC support
+    #  - Specific linecard (F3)
+    #  - Bridge Domain Configuration
+    #  - Feature vni
+    intf = mt_full_env_setup
+    global_setup
+
+    i = Interface.new(intf)
+    i.switchport_mode = :trunk
+    i.vlan_mapping = []
+    assert_equal([], i.vlan_mapping, 'Initial cleanup failed')
+
+    # Initial 'should' state
+    # rubocop:disable Style/WordArray
+    master = [['20', '21'],
+              ['40', '41'],
+              ['60', '61'],
+              ['80', '81']]
+    # rubocop:enable Style/WordArray
+
+    # Test: Add all mappings when no cmds are present
+    should = master.clone
+    i.vlan_mapping = should
+    result = i.vlan_mapping
+    assert_equal(should.sort, result.sort,
+                 'Test 1a. From empty, to all mappings')
+    i.vlan_mapping_enable = false
+    refute(i.vlan_mapping_enable,
+           'Test 1b. Initial test, set to disabled')
+
+    # Test: remove half of the mappings
+    should.shift(2)
+    i.vlan_mapping = should
+    result = i.vlan_mapping
+    assert_equal(should.sort, result.sort,
+                 'Test 2a. Remove half of the mappings')
+    i.vlan_mapping_enable = true
+    assert(i.vlan_mapping_enable,
+           'Test 2b. Back to enabled')
+
+    # Test: restore the removed mappings
+    should = master.clone
+    i.vlan_mapping = should
+    result = i.vlan_mapping
+    assert_equal(should.sort, result.sort,
+                 'Test 3a. Restore the removed mappings')
+    i.vlan_mapping_enable = false
+    refute(i.vlan_mapping_enable,
+           'Test 3b. Back to disabled')
+
+    # Test: Change original-vlan on existing commands
+    should = should.map do |original, translated|
+      [original + '1', translated]
+    end
+    i.vlan_mapping = should
+    result = i.vlan_mapping
+    assert_equal(should.sort, result.sort,
+                 'Test 4. Change original-vlan on existing commands')
+
+    # Test: Change translated-vlan on existing commands
+    should = should.map do |original, translated|
+      [original, translated + '1']
+    end
+    i.vlan_mapping = should
+    result = i.vlan_mapping
+    assert_equal(should.sort, result.sort,
+                 'Test 5. Change translated-vlan on existing commands')
+
+    # Test: 'default'
+    should = i.default_vlan_mapping
+    i.vlan_mapping = should
+    result = i.vlan_mapping
+    assert_equal(should.sort, result.sort,
+                 "Test 6a. 'default'")
+    i.vlan_mapping_enable = i.default_vlan_mapping_enable
+    assert(i.vlan_mapping_enable,
+           "Test 6b. 'default'")
+  end
+end