Skip to content

v4 Release Notes

v4.2.0 (2025-07-18)

Changes

  • Enhanced Installation Guide.
  • All data in Ingestion detail views (newly statistics and tabs) are now updated every 5 seconds with the logs.
  • Most issues during ingestion are now stored as IPFabricIngestionIssue objects and can be viewed in separate Ingestion detail tab view.
  • Ingestion will show as passed when no errors occurred and only some issues were found.
  • Added extra group for IPF SDK version 7.3.

Fixes

  • Device topology view was using the wrong data for Site ID.
  • Sync settings are more strictly respected in the sync process. This applies for all models but Device and Interface which need to be obtained from the database if their child models are asked to be synced.

v4.1.0 (2025-06-24)

Changes

  • Added IPFabricTransformMapGroup model to group IPFabricTransformMap objects together.
  • Restoring transform maps restores only those with no group assigned.
  • Sync now prioritizes using transform maps from groups specified in the sync settings.
  • Dropped extra group support for IPF SDK < 6.10 and added version 7.2.

Fixes

  • Fixed topology view hanging on error.
  • Updated docs to incorporate local_settings.py into configuration.py.

v4.0.1 (2025-06-03)

Fixes

  • NetBox plugin list showed the previous version as installed.

v4.0.0 (2025-05-27)

Changes

Required upgrade steps

For successful migration please follow netbox-branching installation instructions. Step 3 and 4 should be enough since the plugin is installed as dependency and just needs enabling and configuring.

Simplified installation instructions:

Modify your configuration.py with the following content. Replace $ORIGINAL_DATABASE_CONFIG with your original DATABASE configuration dictionary. If you are using other DATABASE_ROUTERS, make sure to include them in the list. 

from netbox_branching.utilities import DynamicSchemaDict

# Wrap DATABASES with DynamicSchemaDict for dynamic schema support
DATABASES = DynamicSchemaDict({
    'default': $ORIGINAL_DATABASE_CONFIG,
})

# Employ netbox-branching custom database router
DATABASE_ROUTERS = [
    'netbox_branching.database.BranchAwareRouter',
]

# Add `netbox-branching` to plugins list (must be last!)
PLUGINS = [
    # ...
    'netbox_branching',
]

Danger

When upgrading to v4.0.0+, make sure to upgrade at the same step as NetBox to 4.3.0+. If you already upgraded your NetBox instance, follow Cannot resolve bases for [<ModelState: 'ipfabric_netbox.IPFabricBranch'>] instructions.

  • Renamed ingestion -> sync and branch -> ingestion to avoid conflicts with netbox-branching.
  • Renamed Name -> Object in list of ingestion changes and linked to the item if it exists.
  • Removed unused status field from IPFabricTransformMap and cleaned all references.

Fixes

  • Quick search for staged changes was ignoring their values.
  • Sync for InventoryItem failed when name was longer than 64 characters.
  • Unable to delete IP Fabric Ingestion in UI.
  • Data were not validated on model save.

Warning

This will cause more failures during data ingestion. These are not new, but are not hidden anymore. It would cause error when manipulating the faulty object synced by previous versions.

  • Ingestion Job was listed in Sync and not in Ingestion.
  • The Default value for template is empty string instead of None.
  • duplex and speed on Interface take unknown value as None.
  • Correctly set DeviceType when model is empty.
  • Convert platform to slug when using it for DeviceType.
  • Ignored VLAN with VLAN ID 0.
  • Ignore InventoryItems with None serial number.