*** Settings *** Documentation Network interface IPv6 configuration and verification ... tests. Resource ../../lib/bmc_redfish_resource.robot Resource ../../lib/openbmc_ffdc.robot Resource ../../lib/bmc_ipv6_utils.robot Library ../../lib/bmc_network_utils.py Library Collections Test Setup Test Setup Execution Test Teardown Test Teardown Execution Suite Setup Suite Setup Execution Test Tags BMC_IPv6 *** Variables *** ${test_ipv6_addr} 2001:db8:3333:4444:5555:6666:7777:8888 ${test_ipv6_invalid_addr} 2001:db8:3333:4444:5555:6666:7777:JJKK ${test_ipv6_addr1} 2001:db8:3333:4444:5555:6666:7777:9999 # Valid prefix length is a integer ranges from 1 to 128. ${test_prefix_length} 64 *** Test Cases *** Get IPv6 Address And Verify [Documentation] Get IPv6 Address And Verify. [Tags] Get_IPv6_Address_And_Verify FOR ${ipv6_network_configuration} IN @{ipv6_network_configurations} Verify IPv6 On BMC ${ipv6_network_configuration['Address']} END Get PrefixLength And Verify [Documentation] Get IPv6 prefix length and verify. [Tags] Get_PrefixLength_And_Verify FOR ${ipv6_network_configuration} IN @{ipv6_network_configurations} Verify IPv6 On BMC ${ipv6_network_configuration['PrefixLength']} END Get IPv6 Default Gateway And Verify [Documentation] Get IPv6 default gateway and verify. [Tags] Get_IPv6_Default_Gateway_And_Verify ${resp}= Redfish.Get ${REDFISH_NW_ETH_IFACE}${ethernet_interface} ${ipv6_gateway}= Get From Dictionary ${resp.dict} IPv6DefaultGateway Verify IPv6 Default Gateway On BMC ${ipv6_gateway} Verify All Configured IPv6 And PrefixLength On BMC [Documentation] Verify IPv6 address and its prefix length on BMC. [Tags] Verify_All_Configured_IPv6_And_PrefixLength_On_BMC FOR ${ipv6_network_configuration} IN @{ipv6_network_configurations} Verify IPv6 And PrefixLength ${ipv6_network_configuration['Address']} ... ${ipv6_network_configuration['PrefixLength']} END Configure IPv6 Address And Verify [Documentation] Configure IPv6 address and verify. [Tags] Configure_IPv6_Address_And_Verify [Template] Configure IPv6 Address On BMC # IPv6 address Prefix length ${test_ipv6_addr} ${test_prefix_length} Delete IPv6 Address And Verify [Documentation] Delete IPv6 address and verify. [Tags] Delete_IPv6_Address_And_Verify Configure IPv6 Address On BMC ${test_ipv6_addr} ${test_prefix_length} Delete IPv6 Address ${test_ipv6_addr} Modify IPv6 Address And Verify [Documentation] Modify IPv6 address and verify. [Tags] Modify_IPv6_Address_And_Verify Configure IPv6 Address On BMC ${test_ipv6_addr} ${test_prefix_length} Modify IPv6 Address ${test_ipv6_addr} ${test_ipv6_addr1} ${test_prefix_length} *** Keywords *** Suite Setup Execution [Documentation] Do suite setup execution. ${active_channel_config}= Get Active Channel Config ${ethernet_interface}= Set Variable ${active_channel_config['${CHANNEL_NUMBER}']['name']} Set Suite variable ${ethernet_interface} Test Setup Execution [Documentation] Test setup execution. Redfish.Login @{ipv6_network_configurations}= Get IPv6 Network Configuration Set Test Variable @{ipv6_network_configurations} # Get BMC IPv6 address and prefix length. ${ipv6_data}= Get BMC IPv6 Info Set Test Variable ${ipv6_data} Test Teardown Execution [Documentation] Test teardown execution. FFDC On Test Case Fail Redfish.Logout Get IPv6 Network Configuration [Documentation] Get Ipv6 network configuration. # Sample output: # { # "@odata.id": "/redfish/v1/Managers/${MANAGER_ID}/EthernetInterfaces/eth0", # "@odata.type": "#EthernetInterface.v1_4_1.EthernetInterface", # "DHCPv4": { # "DHCPEnabled": false, # "UseDNSServers": false, # "UseDomainName": true, # "UseNTPServers": false # }, # "DHCPv6": { # "OperatingMode": "Disabled", # "UseDNSServers": false, # "UseDomainName": true, # "UseNTPServers": false # }, # "Description": "Management Network Interface", # "FQDN": "localhost", # "HostName": "localhost", # "IPv4Addresses": [ # { # "Address": "xx.xx.xx.xx", # "AddressOrigin": "Static", # "Gateway": "xx.xx.xx.1", # "SubnetMask": "xx.xx.xx.0" # }, # { # "Address": "169.254.xx.xx", # "AddressOrigin": "IPv4LinkLocal", # "Gateway": "0.0.0.0", # "SubnetMask": "xx.xx.0.0" # }, # ], # "IPv4StaticAddresses": [ # { # "Address": "xx.xx.xx.xx", # "AddressOrigin": "Static", # "Gateway": "xx.xx.xx.1", # "SubnetMask": "xx.xx.0.0" # } # } # ], # "IPv6AddressPolicyTable": [], # "IPv6Addresses": [ # { # "Address": "fe80::xxxx:xxxx:xxxx:xxxx", # "AddressOrigin": "LinkLocal", # "AddressState": null, # "PrefixLength": xx # } # ], # "IPv6DefaultGateway": "", # "IPv6StaticAddresses": [ # { "Address": "xxxx:xxxx:xxxx:xxxx::xxxx", # "AddressOrigin": "Static", # "AddressState": null, # "PrefixLength": xxx # } # ], # "Id": "eth0", # "InterfaceEnabled": true, # "LinkStatus": "LinkUp", # "MACAddress": "xx:xx:xx:xx:xx:xx", # "Name": "Manager Ethernet Interface", # "NameServers": [], # "SpeedMbps": 0, # "StaticNameServers": [], # "Status": { # "Health": "OK", # "HealthRollup": "OK", # "State": "Enabled" # }, # "VLANs": { # "@odata.id": "/redfish/v1/Managers/${MANAGER_ID}/EthernetInterfaces/eth0/VLANs" ${active_channel_config}= Get Active Channel Config ${resp}= Redfish.Get ${REDFISH_NW_ETH_IFACE}${active_channel_config['${CHANNEL_NUMBER}']['name']} @{ipv6_network_configurations}= Get From Dictionary ${resp.dict} IPv6StaticAddresses RETURN @{ipv6_network_configurations} Verify IPv6 And PrefixLength [Documentation] Verify IPv6 address and prefix length on BMC. [Arguments] ${ipv6_addr} ${prefix_len} # Description of the argument(s): # ipv6_addr IPv6 address to be verified. # prefix_len PrefixLength value to be verified. # Catenate IPv6 address and its prefix length. ${ipv6_with_prefix}= Catenate ${ipv6_addr}/${prefix_len} # Get IPv6 address details on BMC using IP command. @{ip_data}= Get BMC IPv6 Info # Verify if IPv6 and prefix length is configured on BMC. Should Contain ${ip_data} ${ipv6_with_prefix} ... msg=IPv6 and prefix length pair does not exist. Configure IPv6 Address On BMC [Documentation] Add IPv6 Address on BMC. [Arguments] ${ipv6_addr} ${prefix_len} ${valid_status_codes}=${HTTP_OK} # Description of argument(s): # ipv6_addr IPv6 address to be added (e.g. "2001:EEEE:2222::2022"). # prefix_len Prefix length for the IPv6 to be added # (e.g. "64"). # valid_status_codes Expected return code from patch operation # (e.g. "200"). ${prefix_length}= Convert To Integer ${prefix_len} ${empty_dict}= Create Dictionary ${ipv6_data}= Create Dictionary Address=${ipv6_addr} ... PrefixLength=${prefix_length} ${patch_list}= Create List # Get existing static IPv6 configurations on BMC. ${ipv6_network_configurations}= Get IPv6 Network Configuration ${num_entries}= Get Length ${ipv6_network_configurations} FOR ${INDEX} IN RANGE 0 ${num_entries} Append To List ${patch_list} ${empty_dict} END ${valid_status_codes}= Run Keyword If '${valid_status_codes}' == '${HTTP_OK}' ... Set Variable ${HTTP_OK},${HTTP_NO_CONTENT} ... ELSE Set Variable ${valid_status_codes} # We need not check for existence of IPv6 on BMC while adding. Append To List ${patch_list} ${ipv6_data} ${data}= Create Dictionary IPv6StaticAddresses=${patch_list} ${active_channel_config}= Get Active Channel Config ${ethernet_interface}= Set Variable ${active_channel_config['${CHANNEL_NUMBER}']['name']} Redfish.patch ${REDFISH_NW_ETH_IFACE}${ethernet_interface} body=&{data} ... valid_status_codes=[${valid_status_codes}] Return From Keyword If '${valid_status_codes}' != '${HTTP_OK},${HTTP_NO_CONTENT}' # Note: Network restart takes around 15-18s after patch request processing. Sleep ${NETWORK_TIMEOUT}s Wait For Host To Ping ${OPENBMC_HOST} ${NETWORK_TIMEOUT} Verify IPv6 And PrefixLength ${ipv6_addr} ${prefix_len} # Verify if existing static IPv6 addresses still exist. FOR ${ipv6_network_configuration} IN @{ipv6_network_configurations} Verify IPv6 On BMC ${ipv6_network_configuration['Address']} END Validate IPv6 Network Config On BMC Validate IPv6 Network Config On BMC [Documentation] Check that IPv6 network info obtained via redfish matches info ... obtained via CLI. @{ipv6_network_configurations}= Get IPv6 Network Configuration ${ipv6_data}= Get BMC IPv6 Info FOR ${ipv6_network_configuration} IN @{ipv6_network_configurations} Should Contain Match ${ipv6_data} ${ipv6_network_configuration['Address']}/* ... msg=IPv6 address does not exist. END Delete IPv6 Address [Documentation] Delete IPv6 address of BMC. [Arguments] ${ipv6_addr} ${valid_status_codes}=${HTTP_OK} # Description of argument(s): # ipv6_addr IPv6 address to be deleted (e.g. "2001:1234:1234:1234::1234"). # valid_status_codes Expected return code from patch operation # (e.g. "200"). See prolog of rest_request # method in redfish_plus.py for details. ${empty_dict}= Create Dictionary ${patch_list}= Create List @{ipv6_network_configurations}= Get IPv6 Network Configuration FOR ${ipv6_network_configuration} IN @{ipv6_network_configurations} IF '${ipv6_network_configuration['Address']}' == '${ipv6_addr}' Append To List ${patch_list} ${null} ELSE Append To List ${patch_list} ${empty_dict} END END ${ip_found}= Run Keyword And Return Status List Should Contain Value ... ${patch_list} ${null} msg=${ipv6_addr} does not exist on BMC Pass Execution If ${ip_found} == ${False} ${ipv6_addr} does not exist on BMC # Run patch command only if given IP is found on BMC ${data}= Create Dictionary IPv6StaticAddresses=${patch_list} ${active_channel_config}= Get Active Channel Config ${ethernet_interface}= Set Variable ${active_channel_config['${CHANNEL_NUMBER}']['name']} Redfish.patch ${REDFISH_NW_ETH_IFACE}${ethernet_interface} body=&{data} ... valid_status_codes=[${valid_status_codes}] # Note: Network restart takes around 15-18s after patch request processing Sleep ${NETWORK_TIMEOUT}s Wait For Host To Ping ${OPENBMC_HOST} ${NETWORK_TIMEOUT} # IPv6 address that is deleted should not be there on BMC. ${delete_status}= Run Keyword And Return Status Verify IPv6 On BMC ${ipv6_addr} IF '${valid_status_codes}' == '${HTTP_OK}' Should Be True '${delete_status}' == '${False}' ELSE Should Be True '${delete_status}' == '${True}' END Validate IPv6 Network Config On BMC Modify IPv6 Address [Documentation] Modify and verify IPv6 address of BMC. [Arguments] ${ipv6} ${new_ipv6} ${prefix_len} ... ${valid_status_codes}=[${HTTP_OK}, ${HTTP_NO_CONTENT}] # Description of argument(s): # ipv6 IPv6 address to be replaced (e.g. "2001:AABB:CCDD::AAFF"). # new_ipv6 New IPv6 address to be configured. # prefix_len Prefix length value (Range 1 to 128). # valid_status_codes Expected return code from patch operation # (e.g. "200", "201"). ${empty_dict}= Create Dictionary ${patch_list}= Create List ${prefix_length}= Convert To Integer ${prefix_len} ${ipv6_data}= Create Dictionary ... Address=${new_ipv6} PrefixLength=${prefix_length} # Sample IPv6 network configurations: # "IPv6AddressPolicyTable": [], # "IPv6Addresses": [ # { # "Address": "X002:db8:0:2::XX0", # "AddressOrigin": "DHCPv6", # "PrefixLength": 128 # }, # { # "Address": “X002:db8:0:2:a94:XXff:fe82:XXXX", # "AddressOrigin": "SLAAC", # "PrefixLength": 64 # }, # { # "Address": “Y002:db8:0:2:a94:efff:fe82:5000", # "AddressOrigin": "Static", # "PrefixLength": 56 # }, # { # "Address": “Z002:db8:0:2:a94:efff:fe82:5000", # "AddressOrigin": "Static", # "PrefixLength": 56 # }, # { # "Address": “Xe80::a94:efff:YYYY:XXXX", # "AddressOrigin": "LinkLocal", # "PrefixLength": 64 # }, # { # "Address": “X002:db8:1:2:eff:233:fee:546", # "AddressOrigin": "Static", # "PrefixLength": 56 # } # ], # "IPv6DefaultGateway": “XXXX::ab2e:80fe:87df:XXXX”, # "IPv6StaticAddresses": [ # { # "Address": “X002:db8:0:2:a94:efff:fe82:5000", # "PrefixLength": 56 # }, # { # "Address": “Y002:db8:0:2:a94:efff:fe82:5000", # "PrefixLength": 56 # }, # { # "Address": “Z002:db8:1:2:eff:233:fee:546", # "PrefixLength": 56 # } # ], # "IPv6StaticDefaultGateways": [], # Find the position of IPv6 address to be modified. @{ipv6_network_configurations}= Get IPv6 Network Configuration FOR ${ipv6_network_configuration} IN @{ipv6_network_configurations} Run Keyword If '${ipv6_network_configuration['Address']}' == '${ipv6}' ... Append To List ${patch_list} ${ipv6_data} ... ELSE Append To List ${patch_list} ${empty_dict} END # Modify the IPv6 address only if given IPv6 is found ${ip_found}= Run Keyword And Return Status List Should Contain Value ... ${patch_list} ${ipv6_data} msg=${ipv6} does not exist on BMC Pass Execution If ${ip_found} == ${False} ${ipv6} does not exist on BMC ${data}= Create Dictionary IPv6StaticAddresses=${patch_list} ${active_channel_config}= Get Active Channel Config ${ethernet_interface}= Set Variable ${active_channel_config['${CHANNEL_NUMBER}']['name']} Redfish.patch ${REDFISH_NW_ETH_IFACE}${ethernet_interface} ... body=&{data} valid_status_codes=${valid_status_codes} # Note: Network restart takes around 15-18s after patch request processing. Sleep ${NETWORK_TIMEOUT}s Wait For Host To Ping ${OPENBMC_HOST} ${NETWORK_TIMEOUT} # Verify if new IPv6 address is configured on BMC. Verify IPv6 On BMC ${new_ipv6} # Verify if old IPv6 address is erased. ${cmd_status}= Run Keyword And Return Status ... Verify IPv6 On BMC ${ipv6} Should Be Equal ${cmd_status} ${False} msg=Old IPv6 address is not deleted. Validate IPv6 Network Config On BMC