cisco_node_utils 1.2.0 → 1.3.0

data/tests/test_fabricpath_topology.rb

@@ -20,6 +20,8 @@ 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
@@ -36,8 +38,7 @@ class TestFabricpathTopo < CiscoTestCase
 
   def no_feature_fabricpath
     # Turn the feature off for a clean test.
-    config('no feature-set fabricpath')
-    config('no install feature-set fabricpath')
+    config_no_warn('no feature-set fabricpath')
   end
 
   # TESTS
@@ -50,49 +51,27 @@ class TestFabricpathTopo < CiscoTestCase
     assert_equal(:enabled, @topo.fabricpath_feature,
                  'Fabricpath feature should have been enabled')
     topos = FabricpathTopo.topos
-    assert_equal(2, topos.length,
-                 'Number of Topos should be 2')
+    assert_equal(1, topos.length,
+                 'Number of Topos should be 1')
   end
 
   def test_topo_destroy
     # create and test again
-    test_topo_create
-    # puts "deleting Topo #{@topo.topo_name}"
+    @topo = FabricpathTopo.new('2')
     @topo.destroy
     # now it should be wiped out
     topos = FabricpathTopo.topos
-    assert_equal(1, topos.length,
-                 'Number of Topos should be 1 (default)')
-  end
-
-  def test_invalid_topo_id
-    e = assert_raises(CliError) { FabricpathTopo.new('64') }
-    assert_match(/Invalid number.* range/, e.message)
+    assert_equal(0, topos.length,
+                 'Number of Topos should be 0 (only default)')
   end
 
   def test_member_vlans
     @topo = FabricpathTopo.new('25')
-    topos = FabricpathTopo.topos
-    default_topo = topos['0']
-    default_topo_vlans = default_topo.member_vlans.first
-    # puts "vlans in default topo is #{default_topo_vlans}"
-    assert_equal('1..4096', default_topo_vlans,
-                 'default topo should have all VLANS')
-    @topo.member_vlans = ['2..10', '100', '500']
-    topo25_vlans = @topo.member_vlans.join(',')
+    @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,
+    assert_equal('2-10,100,500', topo25_vlans,
                  'Topo 25 not getting set with member vlans')
-    default_topo_vlans = default_topo.member_vlans.join(',')
-    # puts "vlans in default topo is #{default_topo_vlans}"
-    assert_equal('1,11..99,101..499,501..4096', default_topo_vlans,
-                 'default topo should now have the set
-                  1,11..99,101..499,501..4096')
-  end
-
-  def test_member_vlans_invalid
-    @topo = FabricpathTopo.new('25')
-    e = assert_raises(RuntimeError) { @topo.member_vlans = ['1..4095'] }
-    assert_match(%r{Invalid value/range}, e.message)
   end
 end

data/tests/test_feature.rb

@@ -0,0 +1,215 @@
+# Copyright (c) 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/feature'
+require_relative '../lib/cisco_node_utils/vdc'
+
+include Cisco
+
+# TestFeature - Minitest for feature class
+class TestFeature < CiscoTestCase
+  @skip_unless_supported = 'feature'
+
+  ###########
+  # Helpers #
+  ###########
+
+  # feature test helper
+  def feature(feat)
+    # Get the feature name string from the yaml
+    ref = cmd_ref.lookup('feature', feat).to_s[/set_value:.*feature (.*)/]
+
+    if ref
+      feat_str = Regexp.last_match[1]
+    else
+      skip("'feature','#{feat}' is unsupported on this node")
+    end
+
+    # Get current state of feature, then disable it
+    pre_clean_enabled = Feature.send("#{feat}_enabled?")
+    config("no feature #{feat_str}") if pre_clean_enabled
+    refute_show_match(
+      command: "show running | i '#{feat_str}'",
+      pattern: /^#{feat_str}$/,
+      msg:     "#{feat} (#{feat_str}) is still enabled",
+    )
+
+    Feature.send("#{feat}_enable")
+    # Some features (BGP on n5k!) are slow starters...
+    unless Feature.send("#{feat}_enabled?")
+      sleep 1
+      node.cache_flush
+    end
+    assert(Feature.send("#{feat}_enabled?"),
+           "Feature #{feat} (#{feat_str}) is not enabled")
+
+    # Return testbed to pre-clean state
+    config("no feature #{feat_str}") unless pre_clean_enabled
+  end
+
+  ###################
+  # Feature tests   #
+  ###################
+  def test_bgp
+    feature('bgp')
+  end
+
+  def test_fabric_forwarding
+    if node.product_id[/N(3)/]
+      assert_nil(Feature.fabric_forwarding_enabled?)
+      assert_raises(Cisco::UnsupportedError) do
+        Feature.fabric_forwarding_enable
+      end
+      return
+    end
+    skip('This feature is only supported on 7.0(3)I2 images') unless
+      node.os_version[/7.0\(3\)I2\(/]
+    feature('fabric_forwarding')
+  end
+
+  def test_nv_overlay
+    if validate_property_excluded?('feature', 'nv_overlay')
+      assert_nil(Feature.nv_overlay_enabled?)
+      assert_raises(Cisco::UnsupportedError) { Feature.nv_overlay_enable }
+      return
+    end
+
+    # Dependency setup
+    vxlan_linecard?
+    vdc_lc_state('f3')
+    config_no_warn('no feature-set fabricpath')
+
+    feature('nv_overlay')
+  end
+
+  def test_nv_overlay_evpn
+    if node.product_id[/N(3)/]
+      assert_nil(Feature.nv_overlay_evpn_enabled?)
+      assert_raises(Cisco::UnsupportedError) { Feature.nv_overlay_evpn_enable }
+      return
+    end
+    vxlan_linecard?
+    vdc_lc_state('f3')
+
+    # nv_overlay_evpn can't use the 'feature' helper so test it explicitly here
+    # Get current state of feature, then disable it
+    pre_clean_enabled = Feature.nv_overlay_evpn_enabled?
+    feat_str = 'nv overlay evpn'
+    config("no #{feat_str}") if pre_clean_enabled
+
+    refute_show_match(
+      command: "show running | i #{feat_str}",
+      pattern: /^#{feat_str}$/,
+      msg:     "(#{feat_str}) is still enabled",
+    )
+    Feature.nv_overlay_evpn_enable
+    assert(Feature.nv_overlay_evpn_enabled?,
+           "(#{feat_str}) is not enabled")
+  end
+
+  def test_ospf
+    feature('ospf')
+  end
+
+  def test_pim
+    feature('pim')
+  end
+
+  def test_private_vlan
+    feature('private_vlan')
+  end
+
+  def test_tacacs
+    feature('tacacs')
+  end
+
+  def test_vn_segment_vlan_based
+    vxlan_linecard?
+    Feature.nv_overlay_enable unless node.product_id[/N3/]
+    feature('vn_segment_vlan_based')
+  rescue RuntimeError => e
+    hardware_supports_feature?(e.message)
+  end
+
+  def test_vni
+    # Dependency setup
+    vxlan_linecard?
+    vdc_lc_state('f3')
+
+    if node.product_id[/N(5|6)/]
+      Feature.nv_overlay_enable
+    else
+      # vni can't be removed if nv overlay is present
+      config_no_warn('no feature nv overlay')
+    end
+    feature('vni')
+  rescue RuntimeError => e
+    hardware_supports_feature?(e.message)
+  end
+
+  def test_vtp
+    feature('vtp')
+  end
+
+  #####################
+  # Feature-set tests #
+  #####################
+
+  def test_feature_set_fabric
+    if node.product_id[/N(3|8|9)/]
+      assert_nil(Feature.fabric_enabled?)
+      assert_raises(Cisco::UnsupportedError) { Feature.fabric_enable }
+      return
+    end
+    fs = 'feature-set fabric'
+    # Get current state of the feature-set
+    feature_set_installed = Feature.fabric_installed?
+    feature_enabled = Feature.fabric_enabled?
+
+    config("no #{fs} ; no install #{fs}") if feature_set_installed
+    refute_show_match(
+      command: "show running | i '^install #{fs}$'",
+      pattern: /^install #{fs}$/,
+      msg:     "(#{fs}) is still configured",
+    )
+
+    Feature.fabric_enable
+    assert(Feature.fabric_enabled?, "(#{fs}) is not enabled")
+
+    # Return testbed to pre-clean state
+    config("no #{fs}") unless feature_enabled
+    config("no install #{fs}") unless feature_set_installed
+  end
+
+  def test_feature_set_fex
+    if validate_property_excluded?('feature', 'fex')
+      assert_nil(Feature.fex_enabled?)
+      assert_raises(Cisco::UnsupportedError) { Feature.fex_enable }
+      return
+    end
+    fs = 'feature-set fex'
+
+    # clean
+    config("no #{fs} ; no install #{fs}") if Feature.fex_installed?
+    refute_show_match(
+      command: "show running | i '^install #{fs}$'",
+      pattern: /^install #{fs}$/,
+      msg:     "(#{fs}) is still configured",
+    )
+
+    Feature.fex_enable
+    assert(Feature.fex_enabled?, "(#{fs}) is not enabled")
+  end
+end

data/tests/test_grpc.rb

@@ -0,0 +1,166 @@
+#!/usr/bin/env ruby
+#
+# October 2015, Glenn F. Matthews
+#
+# 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 'basetest'
+
+# Test case for Cisco::Client::GRPC::Client class
+class TestGRPC < TestCase
+  @@client = nil # rubocop:disable Style/ClassVars
+
+  def self.runnable_methods
+    # If we're pointed to an NXAPI node (as evidenced by lack of a port num)
+    # then these tests don't apply
+    return [:all_skipped] unless Cisco::Environment.environment[:port]
+    super
+  end
+
+  def all_skipped
+    skip 'Node under test does not appear to use the gRPC client'
+  end
+
+  def client
+    unless @@client
+      client = Cisco::Client::GRPC.new(Cisco::Environment.environment)
+      client.cache_enable = true
+      client.cache_auto = true
+      @@client = client # rubocop:disable Style/ClassVars
+    end
+    @@client
+  end
+
+  def test_auth_failure
+    env = Cisco::Environment.environment.merge(password: 'wrong password')
+    e = assert_raises Cisco::AuthenticationFailed do
+      Cisco::Client::GRPC.new(**env)
+    end
+    assert_equal('gRPC client creation failure: Failed authentication',
+                 e.message)
+  end
+
+  def test_connection_failure
+    # Failure #1: connecting to a port that's listening for a non-gRPC protocol
+    env = Cisco::Environment.environment.merge(port: 23)
+    e = assert_raises Cisco::ConnectionRefused do
+      Cisco::Client::GRPC.new(**env)
+    end
+    assert_equal('gRPC client creation failure: Connection refused: ',
+                 e.message)
+    # Failure #2: Connecting to a port that's not listening at all
+    env = Cisco::Environment.environment.merge(port: 0)
+    e = assert_raises Cisco::ConnectionRefused do
+      Cisco::Client::GRPC.new(**env)
+    end
+    assert_equal('gRPC client creation failure: ' \
+                 'timed out during initial connection: Deadline Exceeded',
+                 e.message)
+  end
+
+  def test_set_cli_string
+    client.set(context: 'int gi0/0/0/0',
+               values:  'description panda')
+    run = client.get(command: 'show run int gi0/0/0/0')
+    assert_match(/description panda/, run)
+  end
+
+  def test_set_cli_array
+    client.set(context: ['int gi0/0/0/0'],
+               values:  ['description elephant'])
+    run = client.get(command: 'show run int gi0/0/0/0')
+    assert_match(/description elephant/, run)
+  end
+
+  def test_set_cli_invalid
+    e = assert_raises Cisco::CliError do
+      client.set(context: ['int gi0/0/0/0'],
+                 values:  ['wark', 'bark bark'])
+    end
+    # rubocop:disable Style/TrailingWhitespace
+    assert_equal('The following commands were rejected:
+  int gi0/0/0/0 wark
+  int gi0/0/0/0 bark bark
+with error:
+
+!! SYNTAX/AUTHORIZATION ERRORS: This configuration failed due to
+!! one or more of the following reasons:
+!!  - the entered commands do not exist,
+!!  - the entered commands have errors in their syntax,
+!!  - the software packages containing the commands are not active,
+!!  - the current user is not a member of a task-group that has 
+!!    permissions to use the commands.
+
+int gi0/0/0/0 wark
+int gi0/0/0/0 bark bark
+
+', e.message)
+    # rubocop:enable Style/TrailingWhitespace
+    # Unlike NXAPI, a gRPC config command is always atomic
+    assert_empty(e.successful_input)
+    assert_equal(['int gi0/0/0/0 wark', 'int gi0/0/0/0 bark bark'],
+                 e.rejected_input)
+  end
+
+  def test_get_cli_default
+    result = client.get(command: 'show debug')
+    s = @device.cmd('show debug')
+    # Strip the leading timestamp and trailing prompt from the telnet output
+    s = s.split("\n")[2..-2].join("\n")
+    assert_equal(s, result)
+  end
+
+  def test_get_cli_invalid
+    assert_raises Cisco::CliError do
+      client.get(command: 'show fuzz')
+    end
+  end
+
+  def test_get_cli_incomplete
+    assert_raises Cisco::CliError do
+      client.get(command: 'show ')
+    end
+  end
+
+  def test_get_cli_explicit
+    result = client.get(command: 'show debug', data_format: :cli)
+    s = @device.cmd('show debug')
+    # Strip the leading timestamp and trailing prompt from the telnet output
+    s = s.split("\n")[2..-2].join("\n")
+    assert_equal(s, result)
+  end
+
+  def test_get_cli_empty
+    result = client.get(command:     'show debug | include foo | exclude foo',
+                        data_format: :cli)
+    assert_nil(result)
+  end
+
+  def test_get_cli_cache
+    result = client.get(command: 'show clock', data_format: :cli)
+    sleep 2
+    assert_equal(result, client.get(command: 'show clock', data_format: :cli))
+  end
+
+  # TODO: add structured output test cases (when supported on XR)
+
+  def test_smart_create
+    autoclient = Cisco::Client.create
+    assert_equal(Cisco::Client::GRPC, autoclient.class)
+    assert(autoclient.supports?(:cli))
+    refute(autoclient.supports?(:nxapi_structured))
+    assert_equal(:ios_xr, autoclient.platform)
+  end
+end