NVIDIA BlueField BMC Software v24.07
NVIDIA BlueField BMC Software v24.07

BlueField Host Network Interface

Under URI redfish/v1/Systems/Bluefield, there is a collection called EthernetInterfaces representing the data ports and the OOB port of the BlueField. It is read-only and contains network information (e.g., IP addresses, MAC addresses).

Copy
Copied!
            

curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<bmc_ip>/redfish/v1/Systems/Bluefield/EthernetInterfaces { "@odata.id": "/redfish/v1/Systems/Bluefield/EthernetInterfaces", "@odata.type": "#EthernetInterfaceCollection.EthernetInterfaceCollection", "Description": "Collection of EthernetInterfaces of the host", "Members": [ { "@odata.id": "/redfish/v1/Systems/Bluefield/EthernetInterfaces/eth0" }, { "@odata.id": "/redfish/v1/Systems/Bluefield/EthernetInterfaces/oob0" } ], "Members@odata.count": 2, "Name": "Ethernet Network Interface Collection" }

Info

The interface object has a field called LinkStatus which is determined by the following rules:

  • If the interface is the OOB port (i.e., oob_net0), LinkStatus would display LinkUp if the port is configured up using ifconfig/ip command.

  • If the interface is a data port (i.e., eth0/eth1 or ib0/ib1), LinkStatus would display NoLink if no QSFP cable is connected. If a QSFP transceiver is connected, the link would appear as LinkUp if the port is configured as up using the ifconfig/ip commands. If not, it displays LinkDown.

Copy
Copied!
            

curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<bmc_ip>/redfish/v1/Systems/Bluefield/EthernetInterfaces/oob0 { "@odata.id": "/redfish/v1/Systems/Bluefield/EthernetInterfaces/oob0", "@odata.type": "#EthernetInterface.v1_6_0.EthernetInterface", "DHCPv4": { "DHCPEnabled": true, "UseDNSServers": false, "UseDomainName": false, "UseNTPServers": false }, "DHCPv6": { "OperatingMode": "Stateful", "UseDNSServers": false, "UseDomainName": false, "UseNTPServers": false }, "Description": "Host Network Interface for port oob0", "IPv4Addresses": [ { "Address": "10.345.41.97", "AddressOrigin": "Static", "Gateway": "0.0.0.0", "SubnetMask": "255.255.240.0" } ], "IPv4StaticAddresses": [ { "Address": "10.345.41.97", "AddressOrigin": "Static", "Gateway": "0.0.0.0", "SubnetMask": "255.255.240.0" } ], "IPv6AddressPolicyTable": [], "IPv6Addresses": [ { "Address": "fe80::a278:c2ff:fe0e:87a4", "AddressOrigin": "Static", "AddressState": null, "PrefixLength": 64 } ], "IPv6DefaultGateway": "0:0:0:0:0:0:0:0", "IPv6StaticAddresses": [ { "Address": "fe80::a278:c2ff:fe0e:87a4", "PrefixLength": 64 } ], "Id": "oob0", "InterfaceEnabled": true, "LinkStatus": "LinkUp", "MACAddress": "a0:88:a2:0e:87:a4", "MTUSize": 1500, "Name": "Host Ethernet Interface", "NameServers": [], "SpeedMbps": 1000, "StaticNameServers": [], "Status": { "State": "Disabled" } }

Note

If the user changed the BlueField's IP information dynamically, rebooting the BMC should show the updated IP info.

© Copyright 2024, NVIDIA. Last updated on Aug 16, 2024.