[CEF] Implement Load Sharing Algorithm Support in Terraform Provider

CHANGELOG.md

@@ -11,6 +11,7 @@
 - Add `ip_dhcp_relay_information_option_vpn_id` attribute to `iosxe_interface_ethernet` resource and `iosxe_interface_vlan` resource
 - Add `local_routing` attribute to `iosxe_interface_nve` resource and data source
 - Add `ipv4_unicast_maximum_paths_ebgp` and `ipv4_unicast_maximum_paths_ibgp` attributes to the `iosxe_bgp_address_family_ipv4` and `iosxe_bgp_address_family_ipv4_vrf` resources
+- Add `ip_cef_load_sharing_algorithm_include_ports_source`, `ip_cef_load_sharing_algorithm_include_ports_destination`, `ipv6_cef_load_sharing_algorithm_include_ports_source`, `ipv6_cef_load_sharing_algorithm_include_ports_destination`, and `port_channel_load_balance` attributes to `iosxe_system` resource and data source
 
 ## 0.9.3
 

docs/data-sources/system.md

@@ -51,6 +51,8 @@ data "iosxe_system" "example" {
 - `hostname` (String) Set system's network name
 - `id` (String) The path of the retrieved object.
 - `ip_bgp_community_new_format` (Boolean) select aa:nn format for BGP community
+- `ip_cef_load_sharing_algorithm_include_ports_destination` (Boolean)
+- `ip_cef_load_sharing_algorithm_include_ports_source` (Boolean)
 - `ip_domain_list_names` (List of String)
 - `ip_domain_list_vrf` (String)
 - `ip_domain_list_vrf_domain` (String)
@@ -132,6 +134,8 @@ data "iosxe_system" "example" {
 - `ip_tacacs_source_interface_two_gigabit_ethernet` (String) Two GigabitEthernet
 - `ip_tacacs_source_interface_vlan` (Number) Iosxr Vlans
 - `ip_tacacs_source_interface_vrf` (String) VPN Routing/Forwarding parameters
+- `ipv6_cef_load_sharing_algorithm_include_ports_destination` (Boolean)
+- `ipv6_cef_load_sharing_algorithm_include_ports_source` (Boolean)
 - `ipv6_unicast_routing` (Boolean) Enable unicast routing
 - `login_delay` (Number) Set delay between successive fail login
 - `login_on_failure` (Boolean) Set options for failed login attempt
@@ -144,6 +148,7 @@ data "iosxe_system" "example" {
 - `multicast_routing_vrfs` (Attributes List) Select VPN Routing/Forwarding instance (see [below for nested schema](#nestedatt--multicast_routing_vrfs))
 - `multilink_ppp_bundle_name` (String) Select method for naming multilink bundles
 - `pnp_profiles` (Attributes List) PNP profile (see [below for nested schema](#nestedatt--pnp_profiles))
+- `port_channel_load_balance` (String)
 - `redundancy` (Boolean) Enter redundancy mode
 - `redundancy_mode` (String) redundancy mode for this chassis
 - `security_passwords_min_length` (Number) Minimum length of passwords

docs/guides/changelog.md

@@ -20,6 +20,7 @@ description: |-
 - Add `ip_dhcp_relay_information_option_vpn_id` attribute to `iosxe_interface_ethernet` resource and `iosxe_interface_vlan` resource
 - Add `local_routing` attribute to `iosxe_interface_nve` resource and data source
 - Add `ipv4_unicast_maximum_paths_ebgp` and `ipv4_unicast_maximum_paths_ibgp` attributes to the `iosxe_bgp_address_family_ipv4` and `iosxe_bgp_address_family_ipv4_vrf` resources
+- Add `ip_cef_load_sharing_algorithm_include_ports_source`, `ip_cef_load_sharing_algorithm_include_ports_destination`, `ipv6_cef_load_sharing_algorithm_include_ports_source`, `ipv6_cef_load_sharing_algorithm_include_ports_destination`, and `port_channel_load_balance` attributes to `iosxe_system` resource and data source
 
 ## 0.9.3
 

docs/resources/system.md

@@ -45,20 +45,25 @@ resource "iosxe_system" "example" {
       source_interface_gigabit_ethernet = "1/0/1"
     }
   ]
-  diagnostic_bootup_level                            = "minimal"
-  memory_free_low_watermark_processor                = 203038
-  ip_ssh_time_out                                    = 120
-  ip_ssh_authentication_retries                      = 3
-  ip_ssh_bulk_mode                                   = true
-  ip_ssh_bulk_mode_window_size                       = 262144
-  call_home_contact_email                            = "email@test.com"
-  call_home_cisco_tac_1_profile_active               = true
-  call_home_cisco_tac_1_destination_transport_method = "email"
-  ip_nbar_classification_dns_classify_by_domain      = true
-  ip_multicast_route_limit                           = 200000
-  ip_domain_list_vrf_domain                          = "example.com"
-  ip_domain_list_vrf                                 = "VRF1"
-  ip_routing_protocol_purge_interface                = true
+  diagnostic_bootup_level                                   = "minimal"
+  memory_free_low_watermark_processor                       = 203038
+  ip_ssh_time_out                                           = 120
+  ip_ssh_authentication_retries                             = 3
+  ip_ssh_bulk_mode                                          = true
+  ip_ssh_bulk_mode_window_size                              = 262144
+  call_home_contact_email                                   = "email@test.com"
+  call_home_cisco_tac_1_profile_active                      = true
+  call_home_cisco_tac_1_destination_transport_method        = "email"
+  ip_nbar_classification_dns_classify_by_domain             = true
+  ip_multicast_route_limit                                  = 200000
+  ip_domain_list_vrf_domain                                 = "example.com"
+  ip_domain_list_vrf                                        = "VRF1"
+  ip_routing_protocol_purge_interface                       = true
+  ip_cef_load_sharing_algorithm_include_ports_source        = true
+  ip_cef_load_sharing_algorithm_include_ports_destination   = true
+  ipv6_cef_load_sharing_algorithm_include_ports_source      = true
+  ipv6_cef_load_sharing_algorithm_include_ports_destination = true
+  port_channel_load_balance                                 = "src-dst-mixed-ip-port"
 }
 ```
 
@@ -101,6 +106,8 @@ resource "iosxe_system" "example" {
   - Range: `2500`-`10000`
 - `hostname` (String) Set system's network name
 - `ip_bgp_community_new_format` (Boolean) select aa:nn format for BGP community
+- `ip_cef_load_sharing_algorithm_include_ports_destination` (Boolean)
+- `ip_cef_load_sharing_algorithm_include_ports_source` (Boolean)
 - `ip_domain_list_names` (List of String)
 - `ip_domain_list_vrf` (String)
 - `ip_domain_list_vrf_domain` (String)
@@ -199,6 +206,8 @@ resource "iosxe_system" "example" {
 - `ip_tacacs_source_interface_vlan` (Number) Iosxr Vlans
   - Range: `0`-`65535`
 - `ip_tacacs_source_interface_vrf` (String) VPN Routing/Forwarding parameters
+- `ipv6_cef_load_sharing_algorithm_include_ports_destination` (Boolean)
+- `ipv6_cef_load_sharing_algorithm_include_ports_source` (Boolean)
 - `ipv6_unicast_routing` (Boolean) Enable unicast routing
 - `login_delay` (Number) Set delay between successive fail login
   - Range: `1`-`10`
@@ -214,6 +223,7 @@ resource "iosxe_system" "example" {
 - `multilink_ppp_bundle_name` (String) Select method for naming multilink bundles
   - Choices: `authenticated`, `both`, `endpoint`, `rfc`
 - `pnp_profiles` (Attributes List) PNP profile (see [below for nested schema](#nestedatt--pnp_profiles))
+- `port_channel_load_balance` (String) - Choices: `dst-ip`, `dst-mac`, `dst-mixed-ip-port`, `dst-port`, `mpls`, `src-dst-ip`, `src-dst-mac`, `src-dst-mixed-ip-port`, `src-dst-port`, `src-ip`, `src-mac`, `src-mixed-ip-port`, `src-port`, `vlan-dst-ip`, `vlan-dst-mixed-ip-port`, `vlan-src-dst-ip`, `vlan-src-dst-mixed-ip-port`, `vlan-src-ip`, `vlan-src-mixed-ip-port`
 - `redundancy` (Boolean) Enter redundancy mode
 - `redundancy_mode` (String) redundancy mode for this chassis
   - Choices: `none`, `rpr`, `rpr-plus`, `sso`

examples/resources/iosxe_system/resource.tf

@@ -30,18 +30,23 @@ resource "iosxe_system" "example" {
       source_interface_gigabit_ethernet = "1/0/1"
     }
   ]
-  diagnostic_bootup_level                            = "minimal"
-  memory_free_low_watermark_processor                = 203038
-  ip_ssh_time_out                                    = 120
-  ip_ssh_authentication_retries                      = 3
-  ip_ssh_bulk_mode                                   = true
-  ip_ssh_bulk_mode_window_size                       = 262144
-  call_home_contact_email                            = "email@test.com"
-  call_home_cisco_tac_1_profile_active               = true
-  call_home_cisco_tac_1_destination_transport_method = "email"
-  ip_nbar_classification_dns_classify_by_domain      = true
-  ip_multicast_route_limit                           = 200000
-  ip_domain_list_vrf_domain                          = "example.com"
-  ip_domain_list_vrf                                 = "VRF1"
-  ip_routing_protocol_purge_interface                = true
+  diagnostic_bootup_level                                   = "minimal"
+  memory_free_low_watermark_processor                       = 203038
+  ip_ssh_time_out                                           = 120
+  ip_ssh_authentication_retries                             = 3
+  ip_ssh_bulk_mode                                          = true
+  ip_ssh_bulk_mode_window_size                              = 262144
+  call_home_contact_email                                   = "email@test.com"
+  call_home_cisco_tac_1_profile_active                      = true
+  call_home_cisco_tac_1_destination_transport_method        = "email"
+  ip_nbar_classification_dns_classify_by_domain             = true
+  ip_multicast_route_limit                                  = 200000
+  ip_domain_list_vrf_domain                                 = "example.com"
+  ip_domain_list_vrf                                        = "VRF1"
+  ip_routing_protocol_purge_interface                       = true
+  ip_cef_load_sharing_algorithm_include_ports_source        = true
+  ip_cef_load_sharing_algorithm_include_ports_destination   = true
+  ipv6_cef_load_sharing_algorithm_include_ports_source      = true
+  ipv6_cef_load_sharing_algorithm_include_ports_destination = true
+  port_channel_load_balance                                 = "src-dst-mixed-ip-port"
 }

gen/definitions/system.yaml

@@ -651,6 +651,25 @@ attributes:
   - yang_name: ip/routing-new/routing/protocol/purge/interface
     tf_name: ip_routing_protocol_purge_interface
     example: true
+  - yang_name: ip/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/Cisco-IOS-XE-cef:algorithm-v2/alg-type/include-ports/Cisco-IOS-XE-cef:include-ports-v2/source
+    xpath: ip/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/algorithm-v2/include-ports-v2/source
+    tf_name: ip_cef_load_sharing_algorithm_include_ports_source
+    example: true
+  - yang_name: ip/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/Cisco-IOS-XE-cef:algorithm-v2/alg-type/include-ports/Cisco-IOS-XE-cef:include-ports-v2/destination
+    xpath: ip/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/algorithm-v2/include-ports-v2/destination
+    tf_name: ip_cef_load_sharing_algorithm_include_ports_destination
+    example: true
+  - yang_name: ipv6/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/Cisco-IOS-XE-cef:algorithm-v2/alg-type/include-ports/Cisco-IOS-XE-cef:include-ports-v2/source
+    xpath: ipv6/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/algorithm-v2/include-ports-v2/source
+    tf_name: ipv6_cef_load_sharing_algorithm_include_ports_source
+    example: true
+  - yang_name: ipv6/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/Cisco-IOS-XE-cef:algorithm-v2/alg-type/include-ports/Cisco-IOS-XE-cef:include-ports-v2/destination
+    xpath: ipv6/cef-v2/Cisco-IOS-XE-cef:load-sharing-v2/algorithm-v2/include-ports-v2/destination
+    tf_name: ipv6_cef_load_sharing_algorithm_include_ports_destination
+    example: true
+  - yang_name: port-channel/Cisco-IOS-XE-ethernet:load-balance/load-balance
+    tf_name: port_channel_load_balance
+    example: src-dst-mixed-ip-port
 
 test_prerequisites:
   - path: Cisco-IOS-XE-native:native/vrf/definition=VRF1

gen/load_models.go

@@ -44,6 +44,7 @@ var models = []string{
 	"https://raw.githubusercontent.com/YangModels/yang/main/vendor/cisco/xe/17151/Cisco-IOS-XE-logging.yang",
 	"https://raw.githubusercontent.com/YangModels/yang/main/vendor/cisco/xe/17151/Cisco-IOS-XE-ip.yang",
 	"https://raw.githubusercontent.com/YangModels/yang/main/vendor/cisco/xe/17151/Cisco-IOS-XE-ipv6.yang",
+	"https://raw.githubusercontent.com/YangModels/yang/main/vendor/cisco/xe/17151/Cisco-IOS-XE-cef.yang",
 	"https://raw.githubusercontent.com/YangModels/yang/main/vendor/cisco/xe/17151/Cisco-IOS-XE-interfaces.yang",
 	"https://raw.githubusercontent.com/YangModels/yang/main/vendor/cisco/xe/17151/Cisco-IOS-XE-isis.yang",
 	"https://raw.githubusercontent.com/YangModels/yang/main/vendor/cisco/xe/17151/Cisco-IOS-XE-snmp.yang",