IPU-POD128 build and test guide
Sync-Link test
The Sync-Link test verifies the external Sync-Link cabling between IPU-M2000s. You can run a Sync-Link test by
passing the
--sync
option to the test cluster command.
A failing Sync-Link test reports the cables which failed to satisfy the cluster topology that is being tested by
pointing to the IPU-M2000s and Sync-Link port numbers of the failing Sync-Link. In the example command below,
two Sync-Link cables between “ipum1” and “ipum2” fail:
• The link between “ipum1” Sync-Link port 6 and “ipum2” Sync-Link port 2
• The link between “ipum1” Sync-Link port 7 and “ipum2” Sync-Link port 3
This is an indication of either faulty cabling or an incorrect cluster definition that doesn’t reflect the intended
cabling.
$
vipu-admin
test
cluster cluster1 sync
Showing test results for cluster cluster1:
+-----------+----------+--------+----------------------+
| Test Type | Duration | Passed | Summary
|
+===========+==========+========+======================+
| Sync-Link | 0.90s
| x/y
| Failed Sync Links:
|
+-----------+----------+--------+----------------------+
|
|
|
| ipum1:6 <--> 2:ipum2 |
+-----------+----------+--------+----------------------+
|
|
|
| ipum1:7 <--> 3:ipum2 |
+-----------+----------+--------+----------------------+
test (cluster): failed: Some tests failed.
IPU-Link training test
IPU-Link training test verifies IPU-Link readiness for IPU-Links between and within IPU-M2000s (OSFP cables).
An IPU-Link test can be invoked with the
--ipulink
option in the test cluster command. A failing test will indicate
which IPU-Links are failing by pointing to the agent and cluster port enumeration of the failing IPU-Link. In the
following example, we test a cluster where the IPU-Links have been disconnected between the first and second
IPU-M2000 units.
$
vipu-admin
test
cluster cluster1 ipulink
Showing test results for cluster cluster1:
+-----------+----------+--------+----------------------------------------------------+
| Test Type | Duration | Passed |
Summary
|
+===========+==========+========+====================================================+
| IPU-Link | 34.57s
| x/y
| Failed Links
|
+-----------+----------+--------+----------------------------------------------------+
|
|
|
| ipum1:4 [pending g1x1] <--> ipum2:8 [pending g1x1] |
+-----------+----------+--------+----------------------------------------------------+
|
|
|
| ipum1:3 [pending g1x1] <--> ipum2:7 [pending g1x1] |
+-----------+----------+--------+----------------------------------------------------+
|
|
|
| ipum1:2 [pending g1x1] <--> ipum2:6 [pending g1x1] |
+-----------+----------+--------+----------------------------------------------------+
|
|
|
| ipum1:1 [pending g1x1] <--> ipum2:5 [pending g1x1] |
+-----------+----------+--------+----------------------------------------------------+
test (cluster): failed: Some tests failed.
Version: latest (2021-11-25)
83