Skip to content

Releases: cisco/cisco-network-node-utils

Release of cisco-network-node-utils v1.4.1

02 Nov 17:46
Compare
Choose a tag to compare

Added

  • Extend bgp with attributes:
    • event_history_errors
    • event_history_objstore
  • Added support for Cisco NX-OS software release 7.3(0)I5(1)

Release of cisco-network-node-utils v1.4.0

03 Oct 18:28
Compare
Choose a tag to compare

New feature support

Cisco Resources

Added

  • Extend interface with attributes:
    • bfd_echo
    • ipv4_dhcp_relay_addr
    • ipv4_dhcp_relay_info_trust
    • ipv4_dhcp_relay_src_addr_hsrp
    • ipv4_dhcp_relay_src_intf
    • ipv4_dhcp_relay_subnet_broadcast
    • ipv4_dhcp_smart_relay
    • ipv6_dhcp_relay_addr
    • ipv6_dhcp_relay_src_intf
    • storm_control_broadcast
    • storm_control_multicast
    • storm_control_unicast
  • Extend interface_ospf with attributes:
    • bfd
    • mtu_ignore
    • network_type
    • priority
    • shutdown
    • transmit_delay
  • Extend interface_portchannel with attributes:
    • bfd_per_link
  • Extend router_ospf_vrf with attributes:
    • bfd
  • Extend bgp_neighbor with attributes:
    • bfd

Changed

  • Deprecated vlan private-vlan properties and replaced with new methods. New file vlan_DEPRECATED.rb has been created to store the deprecated methods. The old -> new properties are:
Old Name New Name(s)
private_vlan_association pvlan_association
private_vlan_type pvlan_type
  • Deprecated interface private-vlan properties and replaced with new methods. New files interface_DEPRECATED.rb and DEPRECATED.yaml have been created to store the deprecated methods. The old -> new properties are:
Old Name New Name(s)
private_vlan_mapping pvlan_mapping
switchport_mode_private_vlan_host switchport_pvlan_host, switchport_pvlan_promiscuous,
switchport_mode_private_vlan_host_association switchport_pvlan_host_association
switchport_mode_private_vlan_host_promiscous switchport_pvlan_mapping
switchport_mode_private_vlan_trunk_promiscuous switchport_pvlan_trunk_promiscuous
switchport_mode_private_vlan_trunk_secondary switchport_pvlan_trunk_secondary
switchport_private_vlan_association_trunk switchport_pvlan_trunk_association
switchport_private_vlan_mapping_trunk switchport_pvlan_mapping_trunk
switchport_private_vlan_trunk_allowed_vlan switchport_pvlan_trunk_allowed_vlan
switchport_private_vlan_trunk_native_vlan switchport_pvlan_trunk_native_vlan

Release of cisco-network-node-utils v1.3.0

03 May 18:36
Compare
Choose a tag to compare

New feature support

Cisco Resources

Added

  • Added a new property fabric-control for vlan MT-FULL fabricpath
  • Added support for bdi interfaces to interface provider.
  • Added a new node util to handle bridge domain range cli for member vni
  • Added Bridge Domain, VNI and encapsulation profile node utils for MT-FULL on Nexus 7k.
  • Minitests can declare the YAML feature they are exercising, and if the feature is _excluded on the node under test, the test case will automatically be skipped in full.
  • CliErrors raised by any NodeUtil subclass or instance will automatically prepend the to_s method output to make troubleshooting easier.
  • test_feature minitest
  • Extend interface with attributes:
    • ipv4_forwarding
    • stp_bpdufilter, stp_bpduguard, stp_cost, stp_guard, stp_link_type, stp_mst_cost
    • stp_mst_port_priority, stp_port_priority, stp_port_type, stp_vlan_cost, stp_vlan_port_priority
    • switchport_private_vlan_trunk_allowed_vlan, switchport_private_vlan_trunk_native_vlan
    • switchport_mode_private_vlan_host, switchport_mode_private_vlan_host_association
    • switchport_mode_private_vlan_host_promiscous, switchport_mode_private_vlan_trunk_promiscous, switchport_mode_private_vlan_trunk_secondary
    • switchport_private_vlan_association_trunk, switchport_private_vlan_mapping_trunk
    • private_vlan_mapping
  • Extend Feature class with a class method to list feature compatible interfaces
  • Extend vdc with interface_membership methods
  • Extend vpc with vpc+ attributes on Nexus 5k/6k/7k:
    • fabricpath_emulated_switch_id
    • fabricpath_multicast_load_balance (only on Nexus 7k)
    • port_channel_limit (only on Nexus 7k)
  • Extend vlan with attributes:
    • private_vlan_association, private_vlan_type
  • Added N3k native support for portchannel_global

Changed

  • Major refactor and enhancement of CommandReference YAML files:
    • Filtering by platform is now by platform name only.
    • Replaced config_get(_token)?(_append)? with get_command, get_context, and get_value
    • Replaced config_set(_append)? with set_context, and set_value
    • Individual token values can be explicitly marked as optional (e.g., VRF context); tokens not marked as optional are mandatory.
    • Data format (CLI, NXAPI structured) is now assumed to be CLI unless explicitly specified otherwise using the new (get_|set_)?data_format YAML key. No more guessing based on whether a key looks like a hash key or a Regexp.
  • cisco_nxapi Gem is no longer a dependency as the NXAPI client code has been merged into this Gem under the Cisco::Client namespace.
  • Improved minitest logging CLI.
    • ruby test_foo.rb -l debug instead of ruby test_foo.rb -- <host> <user> <pass> debug
    • rake test TESTOPTS='--log-level=debug'
  • Client connectivity is now specified in /etc/cisco_node_utils.yaml or ~/cisco_node_utils.yaml instead of environment variables or command-line arguments to minitest.
    • ruby test_foo.rb -e <node name defined in YAML>
    • rake test TESTOPTS='--environment=default'

Fixed

  • Interface:
    • Correctly restore IP address when changing VRF membership
    • MTU is not supported on loopback interfaces

Removed

  • Removed Node.lazy_connect internal API.
  • Removed vni node util class

Release of cisco-network-node-utils v1.2.0

11 Feb 23:00
Compare
Choose a tag to compare

New feature support

Additional platform support added to existing classes

Cisco Nexus 56xx, 60xx and 7xxx

  • AAA
    • aaa_authentication_login
    • aaa_authentication_login_service
    • aaa_authentication_service
  • BGP
    • bgp
    • bgp_af
    • bgp_af_neighobr
    • bgp_neighbor_af
  • COMMAND_CONFIG
    • command_config (config_parser)
  • DOMAIN
    • dns_domain
    • domain_name
    • name_server
  • INTERFACE
    • interface
  • NTP
    • ntp_config
    • ntp_server
  • OSPF
    • interface_ospf
    • ospf
    • ospf_vrf
  • RADIUS
    • radius_global
  • SNMP
    • snmp_community
    • snmp_group
    • snmp_notification_receiver
    • snmp_server
    • snmp_user
  • SYSLOG
    • syslog_server
    • syslog_setting
  • TACACS
    • tacacs_server
    • tacacs_server_group
    • tacacs_server_host
  • VLAN
    • vlan

Added

  • Cisco::UnsupportedError exception class, raised when a command is explicitly marked as unsupported on a particular class of nodes.
  • Extend bgp with attributes:
    • disable_policy_batching, disable_policy_batching_ipv4, disable_policy_batching_ipv6
    • event_history_cli, event_history_detail, event_history_events, event_history_periodic
    • fast_external_fallover
    • flush_routes
    • isolate
    • neighbor_down_fib_accelerate
    • route_distinguisher
  • Extend bgp_af with attributes:
    • default_metric
    • distance_ebgp, distance_ibgp, distance_local
    • inject_map
    • suppress_inactive
    • table_map
  • Extend interface with attributes:
    • fabric_forwarding_anycast_gateway
    • ipv4_acl_in, ipv4_acl_out, ipv6_acl_in, ipv6_acl_out
    • ipv4_address_secondary, ipv4_arp_timeout
    • vlan_mapping
    • vpc_id, vpc_peer_link
    • switchport mode fabricpath
  • Extend vrf with attributes:
    • vni
  • Extend vlan with attribute:
    • mode

Changed

  • Major refactor and enhancement of CommandReference YAML files:
    • Added support for auto_default, default_only, kind, and multiple
    • Added filtering by product ID (/N7K/) and by client type (cli_nexus)
    • CommandReference methods that do key-value style wildcard substitution now raise an ArgumentError if the result is empty (because not enough parameters were supplied).

Release of cisco-network-node-utils v1.1.0

09 Nov 17:59
Compare
Choose a tag to compare

New feature support

  • BGP
  • NTP
    • ntp_config (@jonnytpuppet)
    • ntp_server (@jonnytpuppet)
  • RADIUS
    • radius_global (@jonnytpuppet)
    • radius_server (@jonnytpuppet)
  • SYSLOG
    • syslog_server (@jonnytpuppet)
    • syslog_setting (@jonnytpuppet)
  • Miscellaneous

Added

  • Enabled Travis-CI integration to automatically run rubocop. Fixed all baseline rubocop warnings.
  • Added git hooks to streamline certain processes:
    • Validate commit message format for consistency
    • Don't allow commit of code failing RuboCop --lint checks
    • If RuboCop is failing any check, warn on commit (but don't fail), and fail on push.
    • Don't allow push without updating CHANGELOG.md
    • Once git hooks are installed, automatically update them on pull/merge (if possible).
    • If using [git-flow]:
      • git flow release start and git flow hotfix start will automatically update CHANGELOG.md and version.rb for the new release version
      • git flow release finish will automatically bump the version number for the develop branch.
  • Minitest enhancements:
    • Code coverage calculation using [SimpleCov]
    • Full Minitest suite can be run by rake test
    • UUT can be specified by the NODE environment variable or at runtime, in addition to the classic method of command line arguments to ruby test_my_file.rb
    • Added config and (assert|refute)_show_match helper methods for testing.
  • Added bin/check_metric_limits.rb helper script in support of refactoring.
  • Added best practices development guide.

Fixed

  • Fixed several bugs in SnmpUser.(auth|priv)_password_equal?
  • Fixed a bug in test_interface.rb that was keeping it from properly exercising the negotiate_auto functionality.
  • Added a cache_flush call in Platform.chassis to work around an infrequent issue.

Changed

  • Added missing steps to CONTRIBUTING.md and README-develop-node-utils-APIs.md
  • Added git config comments
  • Moved platform_info.(rb|yaml) from lib/ to tests/ as it is test-only code.
  • Now requires Minitest ~> 5.0 instead of Minitest < 5.0.

Removed

  • Dropped support for Ruby 1.9.3 as it is end-of-life.
  • Removed test_all_cisco.rb as rake test can auto-discover all tests.

Release of cisco-network-node-utils v1.0.1

18 Sep 14:46
Compare
Choose a tag to compare

Fixed broken documentation links.

Release of cisco-network-node-utils v1.0.0

26 Aug 18:39
Compare
Choose a tag to compare
  • Improved logic in Vtp class to handle the presence or absence of
    'feature vtp' and 'vtp domain' configuration.
  • Fixed missing default_timer_throttle_* APIs in RouterOspfVrf class.
  • Fixed idempotency and area update issues in interface_ospf class.
  • Updated CliError class definition to make it easier to troubleshoot such
    errors when running Puppet modules that use this gem.
  • Added dotted-decimal munging for the area getter in interface_ospf.
  • Added n9000_sample*.rpm to /tests for use with minitests.
  • Updated yum install method to include vrf, fixes minitest issue.
  • Extended cisco_interface with the following attributes:
    • encapsulation dot1q
    • mtu
    • switchport trunk allowed and native vlans
    • vrf member
  • Move misc READMEs into /docs

Version 0.9.0

13 Aug 19:25
Compare
Choose a tag to compare

Early field trial release for use with Cisco NX-OS 7.0(3)I2(1).