使用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)。
• 11.32.0版的POSTMAN工具。

法律簡介：本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

所用硬體的背景資訊

• 它受單個和Multipod設定支援。
• 備用APIC可以連線到交換矩陣中任何POD中的任何枝葉。
• 不會將任何資訊複製到備用控制器，包括管理員憑據。
• 備用APIC上未啟用管理員登入。
• 為了排除冷待機故障，您必須使用SSH作為搶救使用者登入到待機。
• 備用APIC密碼必須與交換矩陣使用的密碼相同。

必要條件

現有ACI應用策略基礎設施控制器(APIC)群集必須完全適合。

必須能夠訪問待命APIC的Cisco整合管理控制器(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狀態顯示為Booting Up。

步驟5.成功新增備用APIC，且狀態為「已批准」。

在APIC cli中驗證影片輸出。

縮寫

ACI:以應用為中心的基礎設施

APIC:以應用程式為中心的基礎架構控制器

CIMC:思科整合式管理控制器

GUI:圖形使用者介面