Проверка кабелей для Nexus Network Fabric

В этой статье описывается проверка кабеля Fabric, где основная функция API диагностики заключается в проверке всех устройств структуры для потенциальных проблем с кабелем. API диагностики оценивает, соответствуют ли подключенные устройства счетам о материалах (BOM) и согласно единицам SKU ресурсов, классифицируя их как совместимые или несоответствующие. Типы устройств включают в себя устройства Customer Edge (CE), Top of Rack (TOR), Management (MGMT) и Сетевый брокер пакетов (NPB). Результаты представлены в формате JSON, охватывая такие сведения, как состояние проверки, ошибки, тип идентификатора и идентификатор соседнего устройства. Эти результаты хранятся в учетной записи хранения, предоставленной клиентом. Перед переходом на шаг развертывания кластера важно устранить ошибки, выявленные в этом отчете.

Дополнительные сведения о BOM см. в номерах SKU оператора Azure Nexus

Необходимые компоненты

• Убедитесь, что Nexus Network Fabric успешно подготовлен.
• Укажите ИДЕНТИФИКАТОР и URL-адрес хранилища Network Fabric с доступом WRITE через запрос в службу поддержки.
• Учетная запись хранения имеет следующие предварительные требования:
  • Учетная запись хранения должна находиться в другом регионе Azure, отличном от региона Azure Network Fabric.
  • Storage Blob Data Contributor роль должна быть назначена Nexus Network Fabric RP учетной записи хранения с доступом.
• служба поддержки Майкрософт необходимо установить исправление Nexus Network Fabric с активным URL-адресом SAS хранилища перед выполнением проверки кабелей.

Создание запроса на поддержку Azure для исправления Nexus Network Fabric:

• Инструкции по созданию запроса поддержка Azure
• Введите Nexus Network Fabric проблему и нажмите кнопку Go.
• Выберите Azure Operator Nexus в качестве службы, с которым у вас возникла проблема.
• Выберите Subscription расположение ресурса.
• Выберите General в поле ресурса и нажмите кнопку Next.
• Выберите Network fabric instance provisioning в командной строке проблемы и нажмите кнопку Next.
• Теперь выберите Create a support request в верхней части колонки поддержки.
• Щелкните Next вкладку Problem description .
• Recommended solution Дождитесь и нажмите ссылку обратно на "Возврат к запросу на поддержку"
• Щелкните Next вкладку Problem description еще раз, чтобы продолжить Additional details
• Введите необходимые сведения о запросе для исправления Nexus Network Fabric и нажмите кнопку Next
• Просмотрите сведения на вкладке Review + create и нажмите кнопку Create.

Примечание.

URL-адрес хранилища (SAS) является коротким. По умолчанию срок действия истекает в восемь часов. Если срок действия URL-адреса SAS истек, структура должна быть повторно исправлена.

Создание URL-адреса хранилища

Чтобы создать контейнер в учетной записи хранения, см. раздел "Создание контейнера"

Примечание.

Введите имя контейнера, используя только строчные буквы.

Чтобы создать URL-адрес SAS для контейнера для предоставления доступа на запись в Nexus Fabric, см. раздел "Создание подписанного URL-адреса общего доступа"

Примечание.

URL-адреса SAS являются короткими. По умолчанию срок действия истекает в восемь часов. Если срок действия URL-адреса SAS истек, необходимо открыть запрос в службу поддержки Майкрософт, чтобы добавить новый URL-адрес.

Проверка кабелей

1. Выполните следующую команду Azure CLI:

   az networkfabric fabric validate-configuration –resource-group "<NFResourceGroupName>" --resource-name "<NFResourceName>" --validate-action "Cabling" --no-wait --debug  
   

   Отображаются следующие (усеченные) выходные данные. Скопируйте URL-адрес из Azure-AsyncOperation раздела выходных данных отладки. Эта часть URL-адреса используется на следующем шаге для проверки состояния операции.

   cli.azure.cli.core.sdk.policies:     'Azure-AsyncOperation': '<Azure-AsyncOperation-endpoint url>'
   

   Следующая ошибка указывает, что Структура не исправлена с допустимым URL-адресом SAS:

   azure.core.exceptions.HttpResponseError: Operation returned an invalid status 'OK'
   

2. Вы можете программно проверить состояние операции, выполнив следующую команду:

   az rest -m get -u "<Azure-AsyncOperation-endpoint url>" 
   {
     "endTime": "<OPERATION_COMPLETION_TIME>",
     "id": "<OPERATION_ID>",
     "name": "OPERATION_NAME",
     "properties": {
       "url": "CABLING_REPORT_STORAGE_URL"
     },
     "resourceId": "<FABRIC_RID>",
     "startTime": "<OPERATION_START_TIME>",
     "status": "Succeeded"
   }
   

   Состояние операции указывает, успешно ли выполнен или завершился сбой API.

   Примечание.

   Операция занимает примерно 20~40 минут, чтобы завершиться на основе количества стоек.

3. Скачайте и считайте проверенные результаты из <CABLING_REPORT_STORAGE_URL> возвращенной команды.

Пример выходных данных показан в следующих разделах.

Пример выходных данных проверки Edge (CE) для поставщика Edge (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 (TOR)

{ 
                      "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 
                          } 
                        } 
                      ]

Состояния проверки

Тип состояния	Определение
Соответствует	Состояние проверки соответствует спецификации BOM для интерфейса.
Несовместимые	Проверка не соответствует спецификации BOM для интерфейса.
Неизвестно	Проверка не может получить сведения о подключении интерфейса или данные lldp не возвращаются. Состояние Unknown возвращается, если целевое устройство отключено, отсутствует, отключено или не поддерживается для этого типа интерфейса.

Атрибуты проверки

Атрибут	Определение
deviceConfiguration	Конфигурация, доступная на устройстве.
error	Ошибка с устройства.
reason	Это поле заполняется, когда состояние устройства неизвестно.
validationType	Этот параметр указывает тип проверки. (проверки спецификации кабелей и кабелей).
deviceDestinationResourceId	Идентификатор Azure Resource Manager подключенного соседа (целевое устройство).
roleName	Роль устройства Network Fabric (CE или TOR).

Известные проблемы и ограничения при проверке кабеля

• Проверка подключений между TOR и вычислительными серверами, которые отключены или не представлены в кластере Nexus, не поддерживаются. Эти интерфейсы показывают Unknown состояние отчета.
• Проверка подключений между интерфейсами MGMT и вычислительными серверами, которые отключены или не представлены в кластере Nexus или контроллерах вычислительных серверов, не поддерживаются. Эти интерфейсы показывают Unknown состояние отчета.
• Проверка кабелей для NPB не поддерживается для и nni-direct интерфейсов, так как в настоящее время show lldp neighborsне поддерживается loopback поставщиком. Эти интерфейсы показывают Unknown состояние отчета.
• URL-адрес хранилища должен находиться в другом регионе, отличном от Network Fabric. Например, если Структура размещена в восточной части США, URL-адрес хранилища должен находиться за пределами восточной части США.
• Проверка кабелей поддерживает четыре стойки с 16 вычислительными ресурсами на стойку и восемь стоек с 16 вычислительными машинами на стойку.
• Если целевое устройство отключено, кабели отсутствуют или отключены, или если проверка не поддерживается для типа интерфейса, интерфейс отображает Unknown состояние. Важно оценить все Unknown интерфейсы, которые относятся Not-Connected к BOM, чтобы определить, требуется ли действие восстановления.

Типичная проверка NonCompliant кабеля и Unknown проблемы

validationType	Состояние	Ошибка	Разрешение
КабельValidation	NonCompliant	Device cable connection is incorrect.	Убедитесь, что подключения к исходному и целевому интерфейсам соответствуют BOM. Это deviceConfiguration может помочь определить дату конечного порта, возвращенную в интерфейсе.
КабельValidation	Unknown	Unable to fetch data from the device.	Убедитесь, что подключения к исходным и конечным интерфейсам подключены и соответствуют BOM
КабельValidation	NonCompliant	Device cabling in <INTERFACE> incorrect.	Интерфейс не подключен. Убедитесь, что подключения к исходному и целевому интерфейсам подключены к BOM.
КабельValidation	Unknown	Port <INTERFACE> has no connections as per device response.	Убедитесь, что подключения к исходным и конечным интерфейсам подключены и соответствуют BOM.
КабельSpecificationValidation	Unknown	Unable to fetch Interface Status for <INTERFACE>.	Убедитесь, что подключения к исходным и конечным интерфейсам подключены и соответствуют BOM.
КабельSpecificationValidation	NonCompliant	Device cable connection is incorrect	Убедитесь, что карточка интерфейса и кабели соответствуют спецификации BOM в этом интерфейсе.

Преобразование отчета проверки кабеля в формат HTML

Сведения о преобразовании выходных данных отчета проверки кабеля в HTML.