Cisco APIC Installation and ACI Upgrade and Downgrade Guide

PDF

Cisco APIC Installation and ACI Upgrade and Downgrade Guide

Switch upgrade examples

Want to summarize with AI?

Log in

Provides examples for managing switch firmware and maintenance policies using API requests. These examples assist administrators in automating switch upgrades and monitoring status.


This topic provides API request examples for configuring switch firmware groups, maintenance policies, and retrieving upgrade status information.

Switch Firmware Group – Group of switches with same firmware policy

POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
				<firmwareFwGrp name="AllswitchesFwGrp" >
				<fabricNodeBlk name="Blk101to104” from_="101" to_="104” />
				<firmwareRsFwgrpp tnFirmwareFwPName="AllswitchesFwP” />
				</firmwareFwGrp>
			

Switch Firmware Firmware Policy – Set desired version

POST URL: http://trunk6-ifc1/api/node/mo/fabric.xml
				<firmwareFwP name="AllswitchesFwP” version="n9000-11.0(0.775)” ignoreCompat="true">
				</firmwareFwP>

Switch Maintenance Group – Group of switches with same maintenance policy

POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
				<maintMaintGrp name="AllswitchesMaintGrp">
				<fabricNodeBlk name="Blk101to104” from_="101" to_="104” />
				<maintRsMgrpp tnMaintMaintPName="AllswitchesMaintP” />
				</maintMaintGrp>

Switch Maintenance Policy – Setup schedule for maitenance

POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
				<maintMaintP name="AllswitchesMaintP” runMode="pauseOnlyOnFailures" >
				</maintMaintP>

Trigger upgrade on Maintenance Group – starting now

POST URL: http://trunk6-ifc1/api/node/mo/uni/fabric.xml
				<maintMaintP name="AllswitchesMaintP" adminSt="triggered">
				</maintMaintP>

Get current running version on switches

(all switches) GET UR : http://trunk6-ifc1.insieme.local/api/node/class/firmwareRunning.xml
				(a switch) GET URL: http://trunk6-ifc1.insieme.local/api/node/mo/topology/pod-1/node-101/sys/fwstatuscont/running.xml
			

Get upgrade status of switches

(all switches) GET URL: http://trunk6-ifc1.insieme.local/api/node/class/maintUpgJob.xml
				(a switch) GET URL: http://trunk6-ifc1.insieme.local/api/node/mo/topology/pod-1/node-101/sys/fwstatuscont/upgjob.xml