IPAM Discovery integration
Summarize
Summary of IPAM Discovery integration
The IP Address Management (IPAM) to Discovery integration in the Yokohama release automates the creation and management of Discovery schedules based on IPv6 network data stored in IPAM. This integration keeps your Discovery schedules synchronized with changes in your IPv6 and IPv4 network infrastructure, ensuring an accurate and current network view.
Show less
How It Works
- Identifies operational resources in IPAM tables.
- Processes only the latest changes to optimize performance.
- Creates Discovery schedules organized by a specified tag key.
- Disables schedules that no longer correspond to valid network targets.
Key Benefits
- Automated schedule management: Eliminates manual effort to create and maintain Discovery schedules for both IPv4 and IPv6 networks.
- Synchronization with network changes: Automatically updates schedules when networks, subnets, or IP addresses change.
- Incremental updates: Improves efficiency by processing only changed resources.
- Dual IP support: Supports both IPv4 and IPv6 with configurable capacity limits.
- Audit capability: Tracks synchronization history and any errors through execution records.
Requirements
- Service Graph Connector Central (SGC Central) v2.4.0 with sgcadmin access.
- Service Graph Connector for Infoblox v1.5.0 with sgcadmin access.
- CMDB Workspace v9.0.0 and Discovery Admin Workspace v1.13.0 with discoveryadmin access.
- ServiceNow AI Platform version Australia ZP8 or later, or YP13 or later.
- IPAM data must include operational managed networks, subnets, and allocated IP addresses with proper relationships and valid CIDR notation for IPv4 subnets.
Configuration
System properties control integration behavior, including:
- Debug logging for troubleshooting.
- Grouping auto-generated Discovery schedules by a tag key from IPAM, such as location.
- Limits on the number of IPv4 and IPv6 addresses per Discovery schedule, configurable to suit environment scale.
Generated Discovery Schedules
- Maintenance source is set to "Discovery-IPAM Integration."
- Schedules are initially inactive to allow review before activation.
- MID Server selection defaults to MID Cluster.
- Descriptions include managed network info, grouping criteria, and navigation links for easy management.
Execution Tracking and Monitoring
Each synchronization run generates an execution record detailing performance, settings, and errors, helping to monitor integration health and prevent conflicts from concurrent executions.
Optimization Recommendations
- Assign subnets to groups in IPAM to enable organized schedule creation.
- Regularly review and adjust generated schedules and configuration.
- Enable debug logging during initial setup to understand integration behavior.
- Ensure IPAM data quality before synchronizations.
- Monitor execution records regularly to identify and resolve issues promptly.
The IP Address Management (IPAM) to Discovery integration feature enables your organization to automatically create and manage Discovery schedules based on your IPv6 network infrastructure data stored in IPAM. This integration keeps your discovery processes synchronized with your IPv6 network changes, providing a complete and up-to-date view of your network environment.
How it works
- Identifying resources marked as operational in your IPAM tables
- Processing only the latest changes from your IPAM system
- Creating Discovery schedules, organized by a tag key you specify
- Disabling schedules that no longer have valid network targets
Benefits
- Automated schedule management: Eliminates the need to manually create and maintain Discovery schedules for IPv4 and IPv6 networks.
- Synchronization with network changes: Automatically adjusts Discovery schedules when networks, subnets, or IP addresses change.
- Incremental updates: Processes only resources that changed since the last synchronization, improving performance.
- IPv4 and IPv6 support: Handles both IPv4 and IPv6 networks with separate capacity limits and mapping approaches.
- Audit capability: Maintains history of synchronization activities and changes through execution records.
Requirements
- Service Graph Connector Central (SGC Central) v2.4.0 with sgc_admin access.
- Service Graph Connector for Infoblox v1.5.0 with sgc_admin access.
- CMDB Workspace v9.0.0.
- Discovery Admin Workspace v1.13.0 with discovery_admin access.
- Australia, ZP8 or later, or YP13 or later version of the ServiceNow AI Platform.
- Managed networks in the Managed Network [cmdb_ci_managed_network] table with operational status set to operational.
- IP subnets in the IP Network Subnet [cmdb_ci_ip_network_subnet] table with operational status set to operational.
- IP addresses in the Allocated IP Address [cmdb_ci_allocated_ip_address] table with operational status set to operational.
- IPv4 subnets should have valid Classless Inter-Domain Routing (CIDR) notation for address calculation.
- Relationships between managed networks, subnets, and IP addresses must be established.
Configuration
The following system properties control the behavior of the integration:
| Property name | Description | Default |
|---|---|---|
| glide.discovery.schedule.autogenerate.debug | Enables detailed logging for troubleshooting. | false |
| glide.discovery.schedule.autogenerate.group | Groups auto-generated IPAM Discovery schedules by a specific tag or attribute. The value of this property represents a key that IPAM retrieves and stores in the Key Values [cmdb_key_value] table. For example, entering "location" as the value would group the schedules by their associated locations. | empty |
| glide.discovery.schedule_ipv4_limit | Defines the maximum number of IPv4 addresses that can be included in a single auto‑generated IPv4 Discovery schedule. | 65,536 |
| glide.discovery.schedule_ipv6_limit | Defines the maximum number of IPv6 addresses that can be included in a single auto‑generated IPv6 Discovery schedule. | 20,000 Note: On instances below ZP3 and YP9, the maximum number of IPv6 addresses per schedule must not exceed 5,000, which is also the default value in Yokohama and earlier releases. |
Generated schedules
- Maintenance source: The maintenance source is set to Discovery-IPAM Integration.
- Initial state: The initial state is set to inactive for review before activation.
- MID Server selection: The MID Server selection is set to MID Cluster.
- Description: Includes managed network, grouping criteria, and navigation links.
Execution tracking
Each synchronization creates an execution record that captures performance metrics, configuration settings, and any errors. The integration helps prevent multiple simultaneous executions to avoid conflicts. Review these execution records to monitor integration health.
Optimization
Follow these guidelines to get the most out of the IPAM Discovery integration:
- Assign subnets to groups: In your IPAM product, assign subnets to groups so the integration can organize schedules based on those groupings.
- Regular maintenance: Periodically review generated schedules and adjust configuration as needed.
- Test with debug logging: Enable debug logging during initial implementation to understand behavior.
- Verify data quality: Verify IPAM data quality before running synchronization.
- Monitor execution records: Review execution records regularly to catch issues early.