> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Itential Tools updated

> Breaking change notice that itential_tools has been updated for Cisco NSO 6.4 compatibility in 2023.2, with required minimum versions of adapter-nso.

## 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`.

### NavNode deprecated methods

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 release | Minimum adapter-nso version |
| ---------------- | --------------------------- |
| 2023.2           | v7.9.4-2023.2.14 or later   |

If you need additional support or require more information, contact the [Product Support Team](https://itential.atlassian.net/servicedesk/customer/portals).

## Related reading

* [Cisco DevNet Community: NSO 6.4](https://community.cisco.com/t5/crosswork-automation-hub-blogs/nso-6-4-long-lived-release-is-out/ba-p/5230069)
* [NSO 6.4 docs](https://nso-docs.cisco.com/guides/nso-6.4)