Cisco Crosswork Hierarchical Controller 8.0.3 Release Notes

This document provides information about:

●       Patch installation procedure with detailed steps to upgrade from 8.0.2 to 8.0.3

●       Issues resolved and known limitations in this release

●       Application updates

Upgrade

Crosswork Hierarchical Controller 8.0.2 can be upgraded to version 8.0.3

Patch installation procedure

Upgrading Crosswork Hierarchical Controller from 8.0.2 to 8.0.3 version requires you to copy and upload the system pack to one of the nodes, pull it to the other instances, and then apply the upgrade on all nodes. 

Note: Also download the adapter service packs. These will be required after the upgrade, and before you re-enable the adapters.  The installation command MUST use the adapter names that are in use prior to upgrading, so record the names that appear in Device Manager. 

Before you begin:

1.     Download the HCO v8.0.3 system pack from cisco.com.

2.     Check if the system status i  s Running.

sedo system status

To upgrade Crosswork Hierarchical Controller 8.0.2 to 8.0.3:

1.     Disable all the adapters. For each adapter:

a.     In the applications bar in Crosswork Hierarchical Controller, select Device Manager > Adapters.

b.    Select the required adapter in the Adapters list on the left.

c.     Select the General tab.

d.    Deselect the Enabled checkbox.

e.    Click Save.

2.     Disable all the adapters on the pods.

sudo kubectl --kubeconfig /etc/kubernetes/admin.conf -n zone-b scale statefulset {adapter}  --replicas=0

Note: Disable only the CDG adapter on the pods if you want to upgrade to HCO 11.0 version.

3.     Make a full backup of the system:

sedo backup create full

4.     Download the backup.

sedo backup download -P <Add password> <add backup name>

The backup file is available in the /nxf folder. Copy the backup file to an easily accessible and secure location on your system.

5.     Copy the system pack provided to one of the instances (e.g. node1).

6.     Upload the system pack (from the node it was copied to, e.g. node1):

sudo sedo system upgrade upload <system-pack-name>

7.     List the available upgrades: 

sudo sedo system upgrade list

8.     (For HA) Pull the system pack on all other instances (there is no need to pull it to the instance on which it was uploaded): 

sudo sedo system upgrade pull <system-pack-name>

9.     Apply the upgrade (on all nodes): 

sudo sedo system upgrade apply

10.  Confirm that the upgrade was successfully applied to all nodes. If any node did not receive the upgrade, reapply it to that node.

Note: The system will not reboot if the upgrade fails to apply on a node.

11.  Check the system status and ensure that the HCO pods are not running.

sedo system status

12.  Reboot to complete (all nodes): 

sudo reboot  

Post-upgrade tasks

1.     Check:

sedo version

sedo system status

Verify that the version is 8.0.3 and the system status is Running.

Check the logs in the folder: nxf-system/controller to be sure there are no issues encountered during the upgrade.

2.     Run the sedo logs brain command to verify that there are no unusual exceptions. If any are found, contact Cisco Customer Support.

3.     Download the adapter service packs. 

4.     Install the adapter service packs. The installation command MUST use the name that was in use prior to upgrading (if this is not the default adapter name, that is, if the DYNAMIC_APP_GUID param was used in the original installation to modify the name, install the new service pack with DYNAMIC_APP_GUID=[adapter name as it was displayed in Device Manager on v8.0.2].

5.     Wait until the adapter pods are re-created using the newly installed service pack, and then validate that the adapter pods are restarted:

sedo system status command

6.     Reconfigure and enable the adapters in Device Manager.

Issues Resolved

Embedded NSO

●       CSCwm90346. An E-Line/L3 service deleted through Embedded NSO, remains visible in the Crosswork Hierarchical Controller SHQL app, 3D Explorer, and Network Inventory app.

Network Inventory

●       CSCwp10702. The L3VPN inventory export does not work.

Crosswork Network Controller

●       CSCwo19622. L3 VPN services deleted from CNC are still available in Crosswork Hierarchical Controller. These should be removed after service deletion.

●       CSCwo27201. CNC Adapter duplicates IGP (IS-IS) links to other domains on multi-domain nodes.

●       CSCwo71837. Persist failing for untagged L3VPN service.

●       CSCwo91020. A common device onboarding flow on CNC (controller) can leave duplicate devices in Device Manager.

●       CSCwo93397. When a termination point for a bundle does not contain the member-ref in the LAG/Bundle is encountered, this stops the import of termination points for all new nodes that are planned for onboarding.

●       CSCwo59163. The cards and ports hierarchy are not properly modeled as inventory_items.

●       CSCwp10488. CNC adapter is generating incorrect URLs for the predefined rules used to cross-launch CNC

CDG adapter

●       CSCwm43296. CDG Adapter. The CNC DLM node query should support paging, ensuring that all nodes are returned.

NSO manager

●       CSCwo71680. The connection closes instantly when subscribing to the restconf stream.

3D explorer

●       CSCwo71682. The SR_SEGMENT link layer is not visualized/selected in the 3D Explorer map.

Known limitations

This section outlines the known limitations of the 8.0.3 release.

For the complete list of limitations and operational considerations in the 8.0 and 8.0.1 and 8.0.2 releases, see Crosswork Hierarchical Controller Release notes.

●       CSCwq14991. Dashboard Widgets Settings displays duplicate numbers in the table after upgrading the HCO from 8.0.2 to 8.0.3 version.

●       CSCwq15143. After upgrading the HCO from 8.0.2 to 8.0.3 version, the Sedo CLI commands sedo hco version and sedo nso version display incorrect version numbers for HCO and NSO.

●       CSCwq15260. After upgrading the HCO from 8.0.3 to 11.0, the graphs linked to the data are not opening.

Application updates

There are no new features.

Release collaterals

All the Cisco Crosswork Hierarchical Controller 8.0 documents are relevant and can be used.

This includes: