Class: Cisco::Feature

Inherits:
NodeUtil show all
Defined in:
lib/cisco_node_utils/feature.rb

Overview

Feature - node util class for managing common features

Class Method Summary collapse

Methods inherited from NodeUtil

client, #client, config_get, #config_get, #config_get_default, config_get_default, config_set, #config_set, #get, #ios_xr?, #nexus?, #node, node, platform, #platform, supports?, #supports?

Class Method Details

.bfd_enable ⇒ Object

Note that in most cases the enable methods should only enable; however, for test purposes it is sometimes convenient to support feature disablement for cleanup purposes.



26
27
28
29
 
# File 'lib/cisco_node_utils/feature.rb', line 26

def self.bfd_enable
  return if bfd_enabled?
  config_set('feature', 'bfd')
end

.bfd_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


31
32
33
34
35
36
37
 
# File 'lib/cisco_node_utils/feature.rb', line 31

def self.bfd_enabled?
  config_get('feature', 'bfd')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end

.bgp_enable ⇒ Object 



40
41
42
43
 
# File 'lib/cisco_node_utils/feature.rb', line 40

def self.bgp_enable
  return if bgp_enabled?
  config_set('feature', 'bgp')
end

.bgp_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


45
46
47
 
# File 'lib/cisco_node_utils/feature.rb', line 45

def self.bgp_enabled?
  config_get('feature', 'bgp')
end

.cli_error_check(result) ⇒ Object 



309
310
311
312
313
314
315
316
317
318
319
320
321
322
 
# File 'lib/cisco_node_utils/feature.rb', line 309

def self.cli_error_check(result)
  # The NXOS feature cli may not raise an exception in some conditions and
  # instead just displays a STDOUT error message; thus NXAPI does not detect
  # the failure and we must catch it by inspecting the "body" hash entry
  # returned by NXAPI. This cli behavior is unlikely to change soon.
  fail result[2]['body'] if
    result[2].is_a?(Hash) &&
    /Hardware is not capable of supporting/.match(result[2]['body'].to_s)

  # Some test environments get result as a string instead of a hash
  fail result if
    result.is_a?(String) &&
    /Hardware is not capable of supporting/.match(result)
end

.compatible_interfaces(feature, property = 'supported_module_pids') ⇒ Object 



325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
 
# File 'lib/cisco_node_utils/feature.rb', line 325

def self.compatible_interfaces(feature, property='supported_module_pids')
  # Figure out the interfaces in a modular switch that are
  # compatible with the given feature (or property within a feature)
  # and return an array of such interfaces
  module_pids = config_get(feature, property)
  return [] if module_pids.nil?
  module_regex = Regexp.new module_pids
  # first get the compatible modules present in the switch
  slots = Platform.slots.select do |_slot, filt_mod|
    filt_mod['pid'] =~ module_regex
  end
  return [] if slots.empty?
  # get the slot numbers only into filtered slots array
  filt_slots = slots.keys.map { |key| key[/\d+/] }
  # now filter interfaces in the vdc based on compatible slots
  vdc = Vdc.new(Vdc.default_vdc_name)
  filt_intfs = vdc.interface_membership.select do |intf|
    filt_slots.include? intf[/\d+/]
  end
  filt_intfs
end

.dhcp_enable ⇒ Object 



50
51
52
53
 
# File 'lib/cisco_node_utils/feature.rb', line 50

def self.dhcp_enable
  return if dhcp_enabled?
  config_set('feature', 'dhcp')
end

.dhcp_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


55
56
57
58
59
60
61
 
# File 'lib/cisco_node_utils/feature.rb', line 55

def self.dhcp_enabled?
  config_get('feature', 'dhcp')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end

.fabric_enable ⇒ Object 



64
65
66
67
68
69
 
# File 'lib/cisco_node_utils/feature.rb', line 64

def self.fabric_enable
  # install feature-set and enable it
  return if fabric_enabled?
  config_set('feature', 'fabric', state: 'install') unless fabric_installed?
  config_set('feature', 'fabric', state: '')
end

.fabric_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


71
72
73
 
# File 'lib/cisco_node_utils/feature.rb', line 71

def self.fabric_enabled?
  config_get('feature', 'fabric') =~ /^enabled/
end

.fabric_forwarding_enable ⇒ Object 



84
85
86
87
88
89
90
91
92
93
94
95
96
 
# File 'lib/cisco_node_utils/feature.rb', line 84

def self.fabric_forwarding_enable
  return if fabric_forwarding_enabled?
  Feature.fabric_enable if Feature.fabric_supported?
  # The feature fabric-forwarding cli is required in some older nxos images
  # but is not present in newer images because nv_overlay_evpn handles
  # both features; therefore feature fabric-forwarding is best-effort
  # and ignored on cli failure.
  begin
    config_set('feature', 'fabric_forwarding')
  rescue Cisco::CliError
    Cisco::Logger.debug '"feature fabric forwarding" CLI was rejected'
  end
end

.fabric_forwarding_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


98
99
100
 
# File 'lib/cisco_node_utils/feature.rb', line 98

def self.fabric_forwarding_enabled?
  config_get('feature', 'fabric_forwarding')
end

.fabric_installed? ⇒ Boolean

Returns:

  • (Boolean) 


75
76
77
 
# File 'lib/cisco_node_utils/feature.rb', line 75

def self.fabric_installed?
  config_get('feature', 'fabric') !~ /^uninstalled/
end

.fabric_supported? ⇒ Boolean

Returns:

  • (Boolean) 


79
80
81
 
# File 'lib/cisco_node_utils/feature.rb', line 79

def self.fabric_supported?
  config_get('feature', 'fabric')
end

.fex_enable ⇒ Object 



103
104
105
106
107
108
 
# File 'lib/cisco_node_utils/feature.rb', line 103

def self.fex_enable
  # install feature-set and enable it
  return if fex_enabled?
  config_set('feature', 'fex', state: 'install') unless fex_installed?
  config_set('feature', 'fex', state: '')
end

.fex_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


110
111
112
 
# File 'lib/cisco_node_utils/feature.rb', line 110

def self.fex_enabled?
  config_get('feature', 'fex') =~ /^enabled/
end

.fex_installed? ⇒ Boolean

Returns:

  • (Boolean) 


114
115
116
 
# File 'lib/cisco_node_utils/feature.rb', line 114

def self.fex_installed?
  config_get('feature', 'fex') !~ /^uninstalled/
end

.fex_supported? ⇒ Boolean

Returns:

  • (Boolean) 


118
119
120
 
# File 'lib/cisco_node_utils/feature.rb', line 118

def self.fex_supported?
  config_get('feature', 'fex')
end

.hsrp_enable ⇒ Object 



123
124
125
126
 
# File 'lib/cisco_node_utils/feature.rb', line 123

def self.hsrp_enable
  return if hsrp_enabled?
  config_set('feature', 'hsrp')
end

.hsrp_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


128
129
130
131
132
133
134
 
# File 'lib/cisco_node_utils/feature.rb', line 128

def self.hsrp_enabled?
  config_get('feature', 'hsrp')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end

.itd_enable ⇒ Object 



137
138
139
140
 
# File 'lib/cisco_node_utils/feature.rb', line 137

def self.itd_enable
  return if itd_enabled?
  config_set('feature', 'itd')
end

.itd_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


142
143
144
145
146
147
148
 
# File 'lib/cisco_node_utils/feature.rb', line 142

def self.itd_enabled?
  config_get('feature', 'itd')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end

.lacp_enable ⇒ Object 



150
151
152
153
 
# File 'lib/cisco_node_utils/feature.rb', line 150

def self.lacp_enable
  return if lacp_enabled?
  config_set('feature', 'lacp')
end

.lacp_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


155
156
157
158
159
160
161
 
# File 'lib/cisco_node_utils/feature.rb', line 155

def self.lacp_enabled?
  config_get('feature', 'lacp')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end

.ngmvpn_disable ⇒ Object 



177
178
179
180
 
# File 'lib/cisco_node_utils/feature.rb', line 177

def self.ngmvpn_disable
  return unless ngmvpn_enabled?
  config_set('feature', 'ngmvpn', state: 'no')
end

.ngmvpn_enable ⇒ Object 



164
165
166
167
 
# File 'lib/cisco_node_utils/feature.rb', line 164

def self.ngmvpn_enable
  return if ngmvpn_enabled?
  config_set('feature', 'ngmvpn', state: '')
end

.ngmvpn_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


169
170
171
172
173
174
175
 
# File 'lib/cisco_node_utils/feature.rb', line 169

def self.ngmvpn_enabled?
  config_get('feature', 'ngmvpn')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end

.nv_overlay_disable ⇒ Object 



190
191
192
193
194
195
196
 
# File 'lib/cisco_node_utils/feature.rb', line 190

def self.nv_overlay_disable
  # Note: vdc platforms restrict this feature to F3 or newer linecards
  # Note: this is for test purposes only
  return unless nv_overlay_enabled?
  config_set('feature', 'nv_overlay', state: 'no')
  sleep 1
end

.nv_overlay_enable ⇒ Object 



183
184
185
186
187
188
 
# File 'lib/cisco_node_utils/feature.rb', line 183

def self.nv_overlay_enable
  # Note: vdc platforms restrict this feature to F3 or newer linecards
  return if nv_overlay_enabled?
  config_set('feature', 'nv_overlay', state: '')
  sleep 1
end

.nv_overlay_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


198
199
200
201
202
203
204
 
# File 'lib/cisco_node_utils/feature.rb', line 198

def self.nv_overlay_enabled?
  config_get('feature', 'nv_overlay')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end

.nv_overlay_evpn_enable ⇒ Object 



211
212
213
214
 
# File 'lib/cisco_node_utils/feature.rb', line 211

def self.nv_overlay_evpn_enable
  return if nv_overlay_evpn_enabled?
  config_set('feature', 'nv_overlay_evpn')
end

.nv_overlay_evpn_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


216
217
218
 
# File 'lib/cisco_node_utils/feature.rb', line 216

def self.nv_overlay_evpn_enabled?
  config_get('feature', 'nv_overlay_evpn')
end

.nv_overlay_evpn_supported? ⇒ Boolean

Returns:

  • (Boolean) 


220
221
222
 
# File 'lib/cisco_node_utils/feature.rb', line 220

def self.nv_overlay_evpn_supported?
  node.cmd_ref.supports?('feature', 'nv_overlay_evpn')
end

.nv_overlay_supported? ⇒ Boolean

Returns:

  • (Boolean) 


206
207
208
 
# File 'lib/cisco_node_utils/feature.rb', line 206

def self.nv_overlay_supported?
  node.cmd_ref.supports?('feature', 'nv_overlay')
end

.ospf_enable ⇒ Object 



225
226
227
228
 
# File 'lib/cisco_node_utils/feature.rb', line 225

def self.ospf_enable
  return if ospf_enabled?
  config_set('feature', 'ospf')
end

.ospf_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


230
231
232
 
# File 'lib/cisco_node_utils/feature.rb', line 230

def self.ospf_enabled?
  config_get('feature', 'ospf')
end

.pim_enable ⇒ Object 



235
236
237
238
 
# File 'lib/cisco_node_utils/feature.rb', line 235

def self.pim_enable
  return if pim_enabled?
  config_set('feature', 'pim')
end

.pim_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


240
241
242
 
# File 'lib/cisco_node_utils/feature.rb', line 240

def self.pim_enabled?
  config_get('feature', 'pim')
end

.private_vlan_enable ⇒ Object 



245
246
247
248
 
# File 'lib/cisco_node_utils/feature.rb', line 245

def self.private_vlan_enable
  return if private_vlan_enabled?
  config_set('feature', 'private_vlan')
end

.private_vlan_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


250
251
252
 
# File 'lib/cisco_node_utils/feature.rb', line 250

def self.private_vlan_enabled?
  config_get('feature', 'private_vlan')
end

.tacacs_enable ⇒ Object 



255
256
257
258
 
# File 'lib/cisco_node_utils/feature.rb', line 255

def self.tacacs_enable
  return if tacacs_enabled? || platform == :ios_xr
  config_set('feature', 'tacacs')
end

.tacacs_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


260
261
262
 
# File 'lib/cisco_node_utils/feature.rb', line 260

def self.tacacs_enabled?
  config_get('feature', 'tacacs')
end

.vn_segment_vlan_based_enable ⇒ Object 



265
266
267
268
269
 
# File 'lib/cisco_node_utils/feature.rb', line 265

def self.vn_segment_vlan_based_enable
  return if vn_segment_vlan_based_enabled?
  result = config_set('feature', 'vn_segment_vlan_based')
  cli_error_check(result)
end

.vn_segment_vlan_based_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


271
272
273
 
# File 'lib/cisco_node_utils/feature.rb', line 271

def self.vn_segment_vlan_based_enabled?
  config_get('feature', 'vn_segment_vlan_based')
end

.vni_enable ⇒ Object 



276
277
278
279
280
 
# File 'lib/cisco_node_utils/feature.rb', line 276

def self.vni_enable
  return if vni_enabled?
  result = config_set('feature', 'vni')
  cli_error_check(result)
end

.vni_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


282
283
284
 
# File 'lib/cisco_node_utils/feature.rb', line 282

def self.vni_enabled?
  config_get('feature', 'vni')
end

.vtp_disable ⇒ Object

Special Case: The only way to remove a vtp instance is by disabling the feature.



295
296
297
298
 
# File 'lib/cisco_node_utils/feature.rb', line 295

def self.vtp_disable
  return unless vtp_enabled?
  config_set('feature', 'vtp', state: 'no')
end

.vtp_enable ⇒ Object 



287
288
289
290
291
 
# File 'lib/cisco_node_utils/feature.rb', line 287

def self.vtp_enable
  return if vtp_enabled?
  result = config_set('feature', 'vtp', state: '')
  cli_error_check(result)
end

.vtp_enabled? ⇒ Boolean

Returns:

  • (Boolean) 


300
301
302
303
304
305
306
 
# File 'lib/cisco_node_utils/feature.rb', line 300

def self.vtp_enabled?
  config_get('feature', 'vtp')
rescue Cisco::CliError => e
  # cmd will syntax reject when feature is not enabled.
  raise unless e.clierror =~ /Syntax error/
  return false
end