Itential Tools updated

Breaking change notice

Several necessary changes have been made to the itential_tools package utility to make it compatible with Cisco NSO 6.4 and higher.

Changes to Itential Tools

With NSO version 6.4, several breaking changes were introduced that made itential_tools no longer compatible — it could not be compiled nor function correctly, primarily due to Log4j updates and deprecated NavNode methods.

Log4j updates

In NSO 6.4, the Log4j library was upgraded to version 2.24.1, resulting in deprecated methods that were replaced with alternatives. The import style also changed in Log4j 2.24.1, requiring modifications to existing import statements. The itential_tools codebase has been updated to support Log4j 2.24.1.

In NSO 6.4, the getChanges() method was deprecated in NavNode and replaced with alternatives. The itential_tools codebase has been updated to support this change.

What should I do?

The updated itential_tools is compatible only with Cisco NSO 6.4 and higher and is not backward compatible with earlier versions of NSO. If you are using NSO 6.4 or later, use the updated itential_tools package available in the software repository.

The adapter-nso codebase has also been updated to ensure compatibility with both the new itential-tools-64 and the existing itential_tools packages. Use the following minimum version of adapter-nso:

Itential releaseMinimum adapter-nso version
2023.2v7.9.4-2023.2.14 or later

If you need additional support or require more information, contact the Product Support Team.