Nexus Network Fabric のケーブルを検証する
この記事では、ファブリック ケーブルの検証について説明します。ここでの診断 API の主な機能は、すべてのファブリック デバイスで潜在的なケーブル接続の問題をチェックすることです。 診断 API は、相互接続されたデバイスが部品表 (BOM) に準拠しているかどうかを評価し、それらが準拠デバイスか非準拠デバイスかを分類します。 結果は JSON 形式で作成され、検証状態、エラー、識別子の種類、近隣デバイス ID などの詳細が含まれます。 これらの結果は、顧客が指定したストレージ アカウントに格納されます。 クラスターのデプロイ手順に進む前に、このレポートで特定されたエラーを解決することは、デプロイ全体にとって重要です。
前提条件
- Nexus Network Fabric が正常にプロビジョニングされていることを確認します。
- サポート チケットを使って、書き込みアクセス権を持つ Network Fabric ID とストレージ URL を指定します。
Note
ストレージ URL (SAS) の有効期間は短いです。 既定では、有効期限は 8 時間に設定されます。 SAS URL の有効期限が切れた場合は、ファブリックに再びパッチを適用する必要があります。
ケーブル接続を検証する
次の Azure CLI コマンドを実行します。
az networkfabric fabric validate-configuration –resource-group "<NFResourceGroupName>" --resource-name "<NFResourceName>" --validate-action "Cabling" --no-wait --debug次の (切り捨てられた) 出力が表示されます。 プライベート プレビューで URL をコピーします。 URL のこの部分は、次の手順で操作の状態を確認するために使われます。
https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS2EUAP/operationStatuses/59fdc0c8-eeb1-4258-9163-3cf096490148*A9E6DB3DF5C58D67BD395F7A608C056BC8219C392CC1CE0AD22E4C36D70CEE5C?api-version=2022-01-15-privatepreview&t=638485032018035520&c=MIIHHjCCBgagAwIBAgITfwKWMg6goKCq4WwU2AAEApYyDjANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDIwHhcNMjQwMTMwMTAzMDI3WhcNMjUwMTI0MTAzMDI3WjBAMT4wPAYDVQQDEzVhc3luY29wZXJhdGlvbnNpZ25pbmdjZXJ0aWZpY2F0ZS5tYW5hZ2VtZW50LmF6dXJlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALMk1pBZQQoNY8tos8XBaEjHjcdWubRHrQk5CqKcX3tpFfukMI0_PVZK-Kr7xkZFQTYp_ItaM2RPRDXx-0W9-mmrUBKvdcQ0rdjcSXDek7GvWS29F5sDHojD1v3e9k2jJa4cVSWwdIguvXmdUa57t1EHxqtDzTL4WmjXitzY8QOIHLMRLyXUNg3Gqfxch40cmQeBoN4rVMlP31LizDfdwRyT1qghK7vgvworA3D9rE00aM0n7TcBH9I0mu-96JE0gSX1FWXctlEcmdwQmXj_U0sZCu11_Yr6Oa34bmUQHGc3hDvO226L1Au-QsLuRWFLbKJ-0wmSV5b3CbU1kweD5LUCAwEAAaOCBAswggQHMCcGCSsGAQQBgjcVCgQaMBgwCgYIKwYBBQUHAwEwCgYIKwYBBQUHAwIwPQYJKwYBBAGCNxUHBDAwLgYmKwYBBAGCNxUIhpDjDYTVtHiE8Ys-次のコマンドを実行して、操作の状態をプログラムで確認できます。
az rest -m get -u "<Azure-AsyncOperation-endpoint url>"操作の状態は、API が成功したか失敗したかを示します。
Note
この操作は、ラックの数に基づいて完了するまで約 20 - 40 分かかります。
ストレージ URL から検証済みの結果をダウンロードして読み取ります。
出力例を次のセクションに示します。
顧客のエッジ (CE) からプロバイダー エッジ (PE) への検証出力の例
networkFabricInfoSkuId": "M8-A400-A100-C16-ab",
"racks": [
{
"rackId": "AR-SKU-10005",
"networkFabricResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.managedNetworkFabric/networkFabrics/NFName",
"rackInfo": {
"networkConfiguration": {
"configurationState": "Succeeded",
"networkDevices": [
{
"name": "AR-CE1",
"deviceSourceResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/NFName-AggrRack",
"roleName": "CE1",
"deviceSku": "DCS-XXXXXXXXX-36",
"deviceSN": "XXXXXXXXXXX",
"fixedInterfaceMaps": [
{
"name": "Ethernet1/1",
"description": "AR-CE1:Et1/1 to PE1:EtXX",
"deviceConnectionDescription": "SourceHostName:Ethernet1/1 to DestinationHostName:Ethernet",
"sourceHostname": "SourceHostName",
"sourcePort": "Ethernet1/1",
"destinationHostname": "DestinationHostName",
"destinationPort": "Ethernet",
"identifier": "Ethernet1",
"interfaceType": "Ethernet",
"deviceDestinationResourceId": null,
"speed in Gbps": "400",
"cableSpecification": {
"transceiverType": "400GBASE-FR4",
"transceiverSN": "XKT220900XXX",
"cableSubType": "AOC",
"modelType": "AOC-D-D-400G-10M",
"mediaType": "Straight"
},
"validationResult": [
{
"validationType": "CableValidation",
"status": "Compliant",
"validationDetails": {
"deviceConfiguration": "Device Configuration detail",
"error": null,
"reason": null
}
},
{
"validationType": "CableSpecificationValidation",
"status": "Compliant",
"validationDetails": {
"deviceConfiguration": "Speed: 400 ; MediaType : Straight",
"error": "null",
"reason": null
}
}
]
},
顧客のエッジから Top-of-Rack スイッチの検証
{
"name": "Ethernet11/1",
"description": "AR-CE2:Et11/1 to CR1-TOR1:Et24",
"deviceConnectionDescription": " SourceHostName:Ethernet11/1 to DestinationHostName:Ethernet24",
"sourceHostname": "SourceHostName",
"sourcePort": "Ethernet11/1",
"destinationHostname": "DestinationHostName ",
"destinationPort": "24",
"identifier": "Ethernet11",
"interfaceType": "Ethernet",
"deviceDestinationResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ NFName-CompRack",
"speed in Gbps": "400",
"cableSpecification": {
"transceiverType": "400GBASE-AR8",
"transceiverSN": "XYL221911XXX",
"cableSubType": "AOC",
"modelType": "AOC-D-D-400G-10M",
"mediaType": "Straight"
},
"validationResult": [
{
"validationType": "CableValidation",
"status": "Compliant",
"validationDetails": {
"deviceConfiguration": "Device Configuration detail",
"error": null,
"reason": null
}
},
{
"validationType": "CableSpecificationValidation",
"status": "Compliant",
"validationDetails": {
"deviceConfiguration": "Speed: 400 ; MediaType : Straight",
"error": "",
"reason": null
}
}
]
検証の状態
| 状態の種類 | Definition |
|---|---|
| 対応 | 状態が BOM 仕様に準拠している場合 |
| 非準拠 | 状態が BOM 仕様に準拠していない場合 |
| Unknown | 状態が不明な場合 |
検証属性
| Attribute | Definition |
|---|---|
deviceConfiguration |
デバイスで使用できる構成。 |
error |
デバイスからのエラー |
reason |
このフィールドは、デバイスの状態が不明な場合に設定されます。 |
validationType |
このパラメーターは、検証の種類を示します。 (ケーブルおよびケーブル仕様の検証) |
deviceDestinationResourceId |
接続されている近隣 (宛先デバイス) の Azure Resource Manager ID |
roleName |
Network Fabric デバイス (CE または TOR) の役割 |
ケーブル検証に関する既知の問題と制限事項
- TOR とコンピューティング サーバー間の検証後の接続はサポートされていません。
- Arista からの "show lldp neighbors" はサポートされていないため、NPB のケーブル検証はサポートされていません。
- ストレージ URL は、Network Fabric とは異なるリージョンに存在する必要があります。 たとえば、ファブリックが米国東部でホストされている場合、ストレージ URL は米国東部以外である必要があります。
- ケーブル検証は、4 ラックと 8 ラックの BOM の両方をサポートします。
ストレージ URL を生成する
コンテナーを作成する方法については、コンテナーの作成に関する説明を参照してください。
Note
小文字のみを使ってコンテナーの名前を入力します。
コンテナーの SAS URL を作成する方法については、共有アクセス署名の生成に関する説明を参照してください。 SAS の書き込みアクセス許可を指定します。
Note
ESAS URL の有効期間は短いです。 既定では、有効期限は 8 時間に設定されます。 SAS URL の有効期限が切れた場合は、Microsoft サポート チケットを開いて新しい URL を追加する必要があります。