Troubleshooting

No link

Mis-configuration of the switch port or using a cable not supporting link rate

• Ensure the switch port is not down

• Ensure the switch port rate is configured to the same rate as the adapter's port

No link with break-out cable

Misuse of the break-out cable or misconfiguration of the switch's split ports

• Use supported ports on the switch with proper configuration. For further information, please refer to the MLNX_OS User Manual

• Make sure the QSFP breakout cable side is connected to the SwitchX

Physical link fails to negotiate to maximum supported rate

The adapter is running an outdated firmware

Install the latest firmware on the adapter

Physical link fails to come up

The cable is not connected to the port or the port on the other end of the cable is disabled

Ensure that the cable is connected on both ends or use a known working cable

Driver installation fails.

The install script may fail for the following reasons:

• Failed to uninstall the previous installation due to dependencies being used

• The operating system is not supported

• Uninstall the previous driver before installing the new one

• Use a supported operating system and kernel