What's New in Network Discovery v23.2 - Adaptive Applications - BlueCat Gateway - 23.2

Network Discovery Administration Guide

Locale
English
Product name
BlueCat Gateway
Version
23.2

This release includes the following new features:

Updated user interface

This UI for Network Discovery has been completely redesigned while maintaining alignment with the Cloud Discovery & Visibility adaptive app. Features are organized into separate pages, which you can switch between at any time. In the new UI, you can:

  • Use the Settings page to configure settings that enable you to complete installation and setup.

  • Use the Devices page to manage devices. You can add, discover, update, and delete devices. In addition, you can view the logs for individual devices, change the log level as needed, and download the logs as a separate file to your local system.
    Note: Address Manager represents routers and switches as devices.
  • Use the IPv4/IPv6 Reconciliation Policies pages to manage IPv4/IPv6 policies, respectively. You can add, edit, and delete policies, activate or deactivate individual policies, schedule to run a policy at the current time or later, and view the historical status of active policies (including reports on successfully created IP networks, linked IP addresses, and IP network discovery status). In addition, you can view the logs for individual policies, change the log level as needed, and download the logs as a separate file to your local system.

  • Use the Logs page to view the latest management logs and logs for a specific probe. You can also change the log level as needed, and download the logs as a separate file to your local system.

Support for RESTful v2 API

Network Discovery v23.2 introduces the Network Discovery RESTful v2 API. Starting in v23.2, the previous Network Discovery API will now be referred to as the Legacy v1 API, to distinguish it from the new RESTful v2 API. The RESTful v2 API adheres to REST architectural constraints and is hypermedia driven, providing a new way of interacting with Network Discovery. The RESTful v2 API currently covers the Legacy v1 API functionality, and is intended to replace the Legacy v1 API in the future. The following tag names for RESTful v2 API are different from the tag names for v1 REST API:
v1 REST API v2 REST API
management_devices Management Devices Resource
management_installation Management Installation
management_ipv4_recon_policies Management IPv4 Reconciliation Policy Resource
management_ipv6_recon_policies Management IPv6 Reconciliation Policy Resource
management_logger Management Logger Resource
management_ip_spaces Management IP Spaces Resource
management_configurations Management Configurations Resource
discovery_probe Discovery Probe Resource
upload_file Upload File

For more details on accessing the REST API and the Swagger documentation, see Network Discovery Legacy v1 REST API and Network Discovery v2 REST API in the Network Discovery Administration Guide.

Enhancements to v1 REST API endpoints

The following v1 REST API endpoints have been changed to improve clarity and consistency:

Management IPv4 reconciliation policies:

  • In earlier releases: GET .../configurations/{configuration_name}/ipv4_recon_policies/scheduled

    In Network Discovery v23.2: GET .../ipv4_recon_policies/scheduled

  • In earlier releases: GET .../configurations/{configuration_name}/ipv4_recon_policies/run-now

    In Network Discovery v23.2: GET .../ipv4_recon_policies/run-now

Management IPv6 reconciliation policies:

  • In earlier releases: GET .../configurations/{configuration_name}/ipv6_recon_policies/scheduled

    In Network Discovery v23.2: GET .../ipv6_recon_policies/scheduled

  • In earlier releases: GET .../configurations/{configuration_name}/ipv6_recon_policies/run-now

    In Network Discovery v23.2: GET .../ipv6_recon_policies/run-now

New REST API endpoints

The following new endpoints apply to both v1 REST API and v2 REST API. These endpoints further extend the functionality and customizability of Network Discovery. You can find more details about these API endpoints in the in-product Swagger documentation.
  • GET .../ipv4_policy/boundaries: Get all the IPv4 network boundaries of a configuration.
  • GET .../config_network/ipv4_recon_policies: Get all IPv4 reconciliation policies of a configuration.
  • GET .../ipv6_policy/boundaries: Get all the IPv6 network boundaries of a configuration.
  • GET .../config_network/ipv6_recon_policies: Get all IPv6 reconciliation policies of a configuration.
  • GET .../ip_address: Get the IP address spaces filtered by name prefix and configuration name.
  • GET .../ip_network: Get the IP network spaces filtered by name prefix and configuration name.
  • GET .../devices_without_linked: (v1 REST API) Get all devices of a configuration without linked IP addresses and linked IP networks.
  • GET .../devices: (v2 REST API) Get all devices without linked IP addresses and linked IP networks.
  • GET .../devices_with_linked: (v2 REST API) Get all devices with linked IP addresses and linked IP networks.