Itential Tools Updated

Breaking Change Notice

The following is a breaking change in the itential_tools package utility for Itential Platform. We have made several necessary changes to make itential_tools 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. We discovered that it cannot be compiled nor will it function correctly, primarily as a result of 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. Additionally, the import style changed in Log4j 2.24.1, which required modifying existing import statements to align with the new structure.

To ensure compatibility, we updated the itential_tools codebase to support the Log4j 2.24.1 version.

NavNode Deprecated Methods

In NSO 6.4, the getChanges() method was deprecated in NavNode and replaced with alternatives. To ensure compatibility, we made necessary adjustments to itential_tools to support this change.

What should I do?

Itential has upgraded itential_tools to align with changes introduced in Cisco NSO 6.4; however, this updated version is compatible only with Cisco NSO 6.4 and higher, and is not backward compatible with earlier versions of NSO. Therefore, if you're using NSO 6.4 or later, please use the updated itential_tools package available in the software repository.

Secondly, we have updated the adapter-nso codebase to ensure compatibility with both the new itential-tools-64 and the existing itential_tools packages. To take advantage of this compatibility update, you must use one of the following minimum versions of adapter-nso:

Please ensure adapter-nso uses the appropriate versions to avoid compatibility issues.

If you need any additional support using Itential Platform with NSO, or require more information about this breaking change, please reach out to Itential's Product Support Team for assistance.

Related Reading

• Cisco DevNet Community: NSO 6.4

• NSO 6.4 Docs