使用API在Cisco ACI 6.x中配置备用节点

简介

本文档介绍如何在以应用为中心的基础设施(ACI)6.x版本中使用应用编程接口(API)调用(Postman)添加备用节点。作为以下Bug中的解决方法记录。

https://bst.cloudapps.cisco.com/bugsearch/bug/CSCwo01130

使用的组件

本文档中的信息基于运行软件版本6.0(7e)的ACI交换矩阵。

• 运行3个APIC-M3节点和1个APIC-M3作为备用节点的ACI APIC集群。
• ACI版本：6.0(7e)。
• POSTMAN工具，版本为11.32.0。

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

所用硬件的背景信息

• 它受单个和Multipod设置支持。
• 备用APIC可以连接到交换矩阵中任何POD中的任何枝叶。
• 不会将任何信息复制到备用控制器，包括管理员凭证。
• 备用APIC上未启用管理员登录。
• 为了排除冷待机故障，您必须使用SSH作为抢救用户登录到备用。
• 备用APIC密码必须与交换矩阵使用的密码相同。

先决条件

现有ACI应用策略基础设施控制器(APIC)集群必须完全适合。

备用APIC的思科集成管理控制器(CIMC)IP必须可达。

必须安装任何API工具。

APIC GUI和CLI 

Validate that the existing cluster is in fully fit state.



Validate the avread output, health value must be 255 for all APIC.

使用POSTMAN通过API调用添加备用APIC的过程

步骤1.打开Postman工具并发出post请求以登录到APIC-1。成功执行POST API调用后，响应将得到200 OK。

URL-   https://<10.197.205.87>/api/aaaLogin.json

Body- { "aaaUser" : { "attributes": {"name":"admin","pwd":"<password>" } } }

通过API成功登录后，会颁发AAA令牌，这对后续API请求行使用户权限至关重要。

步骤2.发出post请求以进行CIMC验证。成功执行POST API调用后，响应将得到200 OK。

URL- https://<10.197.205.87>/api/workflows/v1/controller/verify

Body- {"address":"<CIMC_IP>","username":"admin","password":"<cimc_password>","addressType":"cimc","controllerType":"physical"}

步骤3.发出post请求以添加备用节点。成功执行POST API调用后，响应将得到200 OK。

URL- https://<10.197.205.87>/api/workflows/v1/controller/add

Body- {"adminPassword":"<standby_APIC_Pass>","force":false,"nodes":[{"nodeName":"<apic_node_name>","controllerType":"physical","nodeId":<24>,"serialNumber":"<standby_serialnumber>","podId":<Pod_id>,"standby":true,"cimc":{"address4":"<CIMC_IP>","username":"admin","password":"<cimc_pass>"},"oobNetwork":{"address4":"<apic_oob_ip/24>","gateway4":"<oob_Gw>","enableIPv4":true}}]}

步骤4.打开APIC-1 GUI并验证备用控制器状态。备用APIC状态显示为正在启动。

步骤5.已成功添加备用APIC，状态为“已批准”。

在APIC cli中验证avread输出。

缩写

ACI:以应用为中心的基础设施

APIC:以应用为中心的基础设施控制器

CIMC:思科集成管理控制器

GUI:图形用户界面