> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/itential-platform/6/release-notes/breaking-changes/itential-tools-updated/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, with required minimum versions of adapter-nso.

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 to align with the new structure. 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. To take advantage of this compatibility update, use one of the following minimum versions of `adapter-nso`:

| Itential release | Minimum adapter-nso version |
| ---------------- | --------------------------- |
| Platform 6+      | v7.9.4-2023.2.14 or later   |
| 2023.2           | v7.9.4-2023.2.14 or later   |
| 2023.1           | v7.8.39-2023.1.34 or later  |

Ensure `adapter-nso` uses the appropriate version to avoid compatibility issues.

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)

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