使用API Explorer和NXOS排除UCS域上的IMM网络故障

下载选项

  • PDF     (1.4 MB)
    在各种设备上使用 Adobe Reader 查看
  • ePub     (1.4 MB)
    在 iPhone、iPad、Android、Sony Reader 或 Windows Phone 上使用各种应用查看
  • Mobi (Kindle)     (691.5 KB)
    在 Kindle 设备上查看或在多个设备上使用 Kindle 应用查看
已更新: 2021 年 11 月 12 日
文档 ID:217561

非歧视性语言

此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。 请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

    简介

    本文档介绍如何在Intersight管理模式下分析统一计算系统(UCS)域的网络连接或数据包寿命，并使用API Explorer和NXOS命令确定服务器的内部连接。

    作者：Cisco TAC工程师Luis Uribe。

    先决条件

    要求

    Cisco 建议您了解以下主题：

    • Intersight
    • 物理网络连接
    • 应用编程接口(API)

    使用的组件

    本文档中的信息基于以下软件和硬件版本：

    • Cisco UCS 6454交换矩阵互联，固件4.2(1e)
    • UCSB-B200-M5刀片服务器，固件4.2(1a)
    • Intersight软件即服务(SaaS)

    本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

    背景信息

    交换矩阵互联和虚拟网络接口(vNIC)之间的连接是通过虚拟电路(称为虚拟接口(VIF))建立的。 这种VIF被固定到上行链路上，并允许与上游网络通信

    在Intersight管理模式下，没有命令将虚拟接口映射到每个服务器，例如show service-profile circuit。API Explorer/NXOS命令可用于确定UCS域内创建的内部电路之间的关系。

    API资源管理器

    API资源管理器可从任一交换矩阵互联（主或从属）的图形用户界面(GUI)获得。 登录到控制台后，导航到Inventory，选择服务器，然后点击Launch API Explorer。

    image1

    API资源管理器包含一个API参考，其中列出了可用的调用。它还包括用于测试API调用的具象状态传输(REST)客户端接口。

    image2

    通过API调用识别VIF

    您可以使用一组API调用确定哪个VIF对应于每个虚拟vNIC。这可以让您更有效地排除NXOS故障。

    在本文档中，使用API调用导航通过以下项目完成：机箱、服务器、网络适配器、vNIC/vHBA。

    API调用

    语法

    获取机箱ID

    /redfish/v1/Chassis

    获取适配器ID

    /redfish/v1/Chassis/{ChassisId}/NetworkAdapters

    GET网络详细信息（vnic/vhba列表）

    /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}

    GET网络设备功能（vNIC配置）

    /redfish/v1/Chassis/{ChassisId}/NetworkAdapters/{NetworkAdapterId}/NetworkDeviceFunctions

    检索机箱ID

    image3

    复制API调用的机箱ID。

    /redfish/v1/Chassis/FLM2402001F

    检索网络适配器ID

    image4

    复制下一个API调用的网络ID。

    /redfish/v1/Chassis/FLM2402001F/NetworkAdapters/UCSB-MLOM-40G-04_FCH23527C67

    检索vNIC ID

    image5

    复制网络适配器ID。

    /redfish/v1/Chassis/FLM2402001F/NetworkAdapters/UCSB-MLOM-40G-04_FCH23527C67/NetworkDeviceFunctions/Vnic-A
    /redfish/v1/Chassis/FLM2402001F/NetworkAdapters/UCSB-MLOM-40G-04_FCH23527C67/NetworkDeviceFunctions/Vnic-B

    检索对应vNIC的VIF ID

    image6

    在本例中，vNIC-A映射到VIF 800。在此处，NXOS命令包含此虚拟接口。

    使用NXOS和Grep过滤器识别VIF

    如果API Explorer不可用，或者您无权访问GUI，则可以使用CLI命令检索VIF信息。

    注意：您必须知道服务器配置文件才能使用这些命令。

    UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show run interface | grep prev 1 IMM-Server-1
    switchport trunk allowed vsan 1
    switchport description SP IMM-Server-1, vHBA vhba-a, Blade:FLM2402001F
    --
    interface Vethernet800
    description SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
    --
    interface Vethernet803
    description SP IMM-Server-1, vNIC Vnic-b, Blade:FLM2402001F
    --
    interface Vethernet804
    description SP IMM-Server-1, vHBA vhba-a, Blade:FLM2402001F

    命令语法

    使用

    show run interface | grep prev 1 <服务器配置文件名称>

    列出与每个vNIC/vHBA关联的万维网

    show run interface | grep prev 1 next 10 <server profile name>

    列出详细的Vethernet配置

    NXOS故障排除

    vNIC映射到对应的Vethernet后，可以使用用于排除物理接口故障的相同命令对NXOS进行分析。

    vNIC的记法是veth - Vethernet。

    show interface brief显示Veth800处于关闭状态，原因为ENM源PIN失败。

    UCS-TS-MXC-P25-6454-IMM-A# connect nxos

UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface brief | grep -i Veth800
Veth800 1 virt trunk down ENM Source Pin Fail auto

    show interface显示Vethernet 800处于初始化状态。

    
UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface Vethernet 800
Vethernet800 is down (initializing)
    Port description is SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
    Hardware is Virtual, address is 0000.abcd.dcba
    Port mode is trunk
    Speed is auto-speed
    Duplex mode is auto
  300 seconds input rate 0 bits/sec, 0 packets/sec
  300 seconds output rate 0 bits/sec, 0 packets/sec
  Rx
    0 unicast packets  0 multicast packets  0 broadcast packets
    0 input packets  0 bytes
    0 input packet drops
  Tx
    0 unicast packets  0 multicast packets  0 broadcast packets
    0 output packets  0 bytes
    0 flood packets
    0 output packet drops


UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show running-config interface Vethernet 800

!Command: show running-config interface Vethernet800
!Running configuration last done at: Mon Sep 27 16:03:46 2021
!Time: Tue Sep 28 14:35:22 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Vethernet800
  description SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
  no lldp transmit
  no lldp receive
  no pinning server sticky
  pinning server pinning-failure link-down
  no cdp enable
  switchport mode trunk
  switchport trunk allowed vlan 1,470
  hardware vethernet mac filtering per-vlan
  bind interface port-channel1280 channel 800
  service-policy type qos input default-IMM-QOS
  no shutdown

    需要将VIF固定到上行链路接口，在这种情况下，show pinning border interface不会显示固定到任何上行链路的以太网。

    UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show pinning border-interfaces 

--------------------+---------+----------------------------------------
Border Interface     Status    SIFs                                    
--------------------+---------+----------------------------------------
Eth1/45              Active    sup-eth1         
Eth1/46              Active    Eth1/1/33

    这表示上行链路需要额外的配置。此输出对应于Ethernet Uplink 1/46的show running configuration。

    UCS-TS-MXC-P25-6454-IMM-B(nx-os)# show running-config interface ethernet 1/45

!Command: show running-config interface Ethernet1/45
!No configuration change since last restart
!Time: Wed Sep 29 05:15:21 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Ethernet1/45
  description Uplink
  pinning border
  switchport mode trunk
  switchport trunk allowed vlan 69,470
  no shutdown

     show mac address-table details that Veth800使用上行链路上不存在的VLAN 1。

    UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show mac address-table 
Legend: 
        * - primary entry, G - Gateway MAC, (R) - Routed MAC, O - Overlay MAC
        age - seconds since last seen,+ - primary entry using vPC Peer-Link,
        (T) - True, (F) - False, C - ControlPlane MAC, ~ - vsan
   VLAN     MAC Address      Type      age     Secure NTFY Ports
---------+-----------------+--------+---------+------+----+------------------
*    1     0025.b501.0036   static   -         F      F    Veth800

    在UCS域中，vNIC和上行链路上也必须包括正在使用的VLAN。VLAN策略在交换矩阵互联上配置VLAN。该图显示了此UCS域的配置。

    image7

    策略上不存在VLAN 1，因此必须添加该策略。 

    选择Edit Policy以允许连接。此更改需要部署UCS域配置文件。

    image8

    image9

    VLAN分配可通过CLI进行验证：

    UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show running-config interface ethernet 1/45

!Command: show running-config interface Ethernet1/45
!Running configuration last done at: Wed Sep 29 07:50:43 2021
!Time: Wed Sep 29 07:59:31 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Ethernet1/45
  description Uplink
  pinning border
  switchport mode trunk
  switchport trunk allowed vlan 1,69,470
  udld disable
  no shutdown

UCS-TS-MXC-P25-6454-IMM-A(nx-os)#

    现在添加了必要的VLAN，可以使用同一组命令检验Vethernet800上的连通性：

    UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface brief | grep -i Veth800
Veth800       1      virt trunk  up      none                     auto 


UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show interface Vethernet 800
Vethernet800 is up
    Port description is SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
    Hardware is Virtual, address is 0000.abcd.dcba
    Port mode is trunk
    Speed is auto-speed
    Duplex mode is auto
  300 seconds input rate 0 bits/sec, 0 packets/sec
  300 seconds output rate 0 bits/sec, 0 packets/sec
  Rx
    0 unicast packets  1 multicast packets  6 broadcast packets
    7 input packets  438 bytes
    0 input packet drops
  Tx
    0 unicast packets  25123 multicast packets  137089 broadcast packets
    162212 output packets  11013203 bytes
    0 flood packets
    0 output packet drops




UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show running-config interface Vethernet 800

!Command: show running-config interface Vethernet800
!Running configuration last done at: Wed Sep 29 07:50:43 2021
!Time: Wed Sep 29 07:55:51 2021

version 9.3(5)I42(1e) Bios:version 05.42 

interface Vethernet800
  description SP IMM-Server-1, vNIC Vnic-A, Blade:FLM2402001F
  no lldp transmit
  no lldp receive
  no pinning server sticky
  pinning server pinning-failure link-down
  switchport mode trunk
  switchport trunk allowed vlan 1,69,470
  hardware vethernet mac filtering per-vlan
  bind interface port-channel1280 channel 800
  service-policy type qos input default-IMM-QOS
  no shutdown

    Veth800列在上行链路以太网接口的固定接口上：

    UCS-TS-MXC-P25-6454-IMM-A(nx-os)# show pinning border-interfaces 

--------------------+---------+----------------------------------------
Border Interface     Status    SIFs                                    
--------------------+---------+----------------------------------------
Eth1/45              Active    sup-eth1 Veth800 Veth803          
Eth1/46              Active    Eth1/1/33                         

Total Interfaces : 2 

UCS-TS-MXC-P25-6454-IMM-A(nx-os)#

    VIF现在已准备好将流量传输到上游网络。

    相关信息

    修订历史记录

    版本 发布日期 备注
    2.0
    12-Nov-2021
    首次公开发布
    1.0
    12-Nov-2021
    初始版本
    TAC Authored

    由思科工程师提供

    • 路易斯·乌里韦
      思科TAC

    此文档是否有帮助?

    Feedback反馈

    联系我们

    本文档适用于以下产品