# IPAM

The IPAM (IP Address Management) module in Infraon Infinity provides a centralized system for storing, organizing, and tracking IP address allocations across the network.

It replaces manual IP-tracking methods, such as spreadsheets, by maintaining an accurate, continuously updated inventory of **IP ranges, subnets,** and **individual IP addresses.** IPAM helps administrators identify available IP addresses, detect conflicts, track usage history, and maintain a structured subnet allocation across multiple sites and networks.

## **How Does it Work**

IPAM operates by defining subnets in a hierarchical structure and automatically assigning IP addresses within those ranges. The system periodically scans these IPs to identify their status based on network reachability and device discovery. Results from these scans update the IP state, capture host details, and identify devices using the IP.

## **What you see on the screen**

The page displays the **hierarchical structure** of IP address groups and their corresponding usage details. The left panel shows the complete container hierarchy, and the main panel lists each **container, subcontainer, block, or subnet** along with configuration details, status, and actions.

![](/files/ab0e843ebff50a01843e6b849b92a4697f87426c)

Users can search, filter, add new IP elements, trigger scans, and open components to view detailed information.

<table><thead><tr><th width="143.4000244140625">Label</th><th width="227.5999755859375">Action</th><th>Description / Example</th></tr></thead><tbody><tr><td><strong>Categories</strong></td><td>Expand/Collapse Hierarchy</td><td>Displays the hierarchical structure:<br><br><strong>Container → Subcontainer → Block → Subnet.</strong><br>Used to navigate between components.</td></tr><tr><td><strong>Search</strong></td><td>Search by keyword</td><td>Allows searching components by name or related value.</td></tr><tr><td><strong>Filter</strong></td><td>Apply filters</td><td>Filters the list by <strong>Field:</strong> Name, Category, IP Version, Network Address, Is Reserved with <strong>conditions:</strong> in, not in, equals, not equals, contains, not contains.</td></tr><tr><td><strong>Go to IP Assets</strong></td><td>Redirect</td><td>Opens the IP Assets page, which displays all discovered IPs, along with their status and device/interface information.</td></tr><tr><td><strong>Actions</strong></td><td>Dropdown selection</td><td><p>Provides module-level actions that can be applied to the selected component. </p><p></p><p><strong>Options include:</strong><br></p><ul><li><a href="/pages/YtZ5fuQvhc8hXhK8xMLU#configurations-and-schedule"><strong>Configuration Schedule</strong> </a>– Opens scheduling options to configure scan schedule or other routine tasks for the selected item.<br></li><li><a href="/pages/YtZ5fuQvhc8hXhK8xMLU#trigger-availability-scan"><strong>Trigger Availability Scan</strong> </a>– Manually initiates an availability scan to check whether IPs in the selected subnet/block are reachable.<br></li><li><a href="/pages/YtZ5fuQvhc8hXhK8xMLU#trigger-inventory-scan"><strong>Trigger Inventory Scan</strong></a> – Initiates an inventory scan to collect device information (hostname, MAC, interfaces) for the selected component.</li></ul></td></tr><tr><td><a href="/pages/5a1cefcd29f81340fa1702f6c892740320859ede#add-components"><strong>Add Item</strong></a></td><td>Add a new component.</td><td><strong>Options include:</strong> - Add Container - Add Subcontainer - Add Block - Add Subnet.</td></tr><tr><td><strong>Name</strong></td><td>Click to View</td><td>Opens the selected component in a pop-up view displaying summary, IP usage, and subnet details.</td></tr><tr><td><strong>Description</strong></td><td>Displays description</td><td>A brief description is defined during creation.</td></tr><tr><td><strong>IP Configuration</strong></td><td>Displays network range</td><td>Shows subnet address and IP version.<br><br><strong>Example:</strong> 192.168.50.0/23, IPv4</td></tr><tr><td><strong>IP Usage Summary</strong></td><td>Hover to view full summary.</td><td>Displays count of total IPs, used, free, transient, reserved, allocated, network, broadcast, and yet-to-scan.</td></tr><tr><td><strong>Availability Scan</strong></td><td>Displays scan status</td><td><p>Indicates availability scan status, such as:<br></p><ul><li>Not Applicable</li><li>Send to Queue in Progress</li><li>Agent Execution In Progress</li><li>Completed</li><li>Waiting For Execution</li></ul></td></tr><tr><td><strong>Inventory Scan</strong></td><td>Displays scan status</td><td><p>Shows the status of the inventory scan:<br></p><ul><li>Not Applicable</li><li>Inventory Group Scan Send to Queue</li><li>Inventory Group Scan Completed</li><li>Inventory Scan Send to Queue</li><li>Waiting for Inventory Scan Retry</li><li>Inventory Scan in Progress</li><li>Inventory Scan Completed</li><li>Inventory Scan Failed</li></ul></td></tr><tr><td><strong>Actions</strong></td><td></td><td></td></tr><tr><td><strong>Visibility Information</strong></td><td>Click to View</td><td>Shows component metadata such as Created By, Creation Time, Last Updated By, Last Updated On, and Customer.</td></tr><tr><td><strong>Edit</strong></td><td>Modify details</td><td>Used to edit name, description, IP configuration, or user visibility settings.</td></tr><tr><td><strong>Scan Availability</strong></td><td>Manual scan trigger</td><td>Runs an availability scan to check if IPs are reachable.</td></tr><tr><td><strong>Delete</strong></td><td>Remove component</td><td>Delete the selected container/subcontainer/block/subnet after confirmation.</td></tr></tbody></table>

### **Bulk Actions**

* Select multiple items using the checkboxes in the left panel to perform actions in bulk.
* When triggering an availability scan, the system validates each selected subnet and displays the count of Valid and Invalid subnets before proceeding.

### **Details View Overview**

When a component (Container, Subcontainer, Block, or Subnet) is added, clicking it opens a detailed pop-up. This view helps users quickly understand the IP structure, utilization, and child items present under that component.

Each pop-up is divided into:

* **Group Summary –** Shows high-level information about the selected component.
* **IP Availability –** Visual overview of scan status and available IPs.
* **IP Used & Available –** Graphical representation of IP usage.
* **Child Tables –** Lists sub-components (Subcontainers, Blocks, Subnets) under the selected item.

#### **Container**

The Container details view provides a complete summary of the top-level IP segment. It displays the total number of IPs available within the container, the scanning status, and the components defined under it.

![](/files/4dcc61e18ad65dd1980d86c4ce4e26ff45704090)

#### **Subcontainer**

The Subcontainer details view shows the IP allocation for a specific container subsection, along with blocks and subnets beneath it.

![](/files/3436251ccd2be68cd3dd930ed006c17db43e3918)

#### **Block**

The Block view displays grouped subnets created for functional or logical grouping. It highlights the total IP allocation inside the block and all subnets belonging to it.

![](/files/e2968a7401aa800bef4543b2894ae8c164416b9d)

#### **Subnet**

The Subnet view displays information about a specific IP segment, including its scanning status and available IP count.

![](/files/be3da017ee3d0a8924063abc09e49964e0235e4d)

### **Status**

IP Assets in Infraon Infinity are automatically classified into different statuses based on scan results, allocation state, and IPAM rules. These statuses help users understand how each IP address is being utilized within the network.

<figure><img src="/files/Q4uAmozPZzfPsq6XBePl" alt=""><figcaption></figcaption></figure>

**IP Assets Status |** Basic Details

<table><thead><tr><th width="122.5999755859375">Status</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><strong>In Use</strong></td><td>Indicates that the IP is currently assigned to a device or host. This status appears after a successful Availability/Inventory Scan detects active usage.</td><td>IP responds to ping or SNMP requests or is allocated via DHCP/static mapping.</td></tr><tr><td><strong>Free</strong></td><td>Shows that the IP address is unused and available for assignment.</td><td>No device responds to this IP address, and it is neither allocated nor reserved.</td></tr><tr><td><strong>Reserved</strong></td><td>The IP is intentionally reserved for future or system-specific use. These IPs cannot be auto-assigned.</td><td>IP reserved for HA setup, firewall rules, or static mapping requirements.</td></tr><tr><td><strong>Allocated</strong></td><td>The IP address is manually allocated or assigned via an integration, but is not currently detected as active on the network.</td><td>IP assigned to an asset in CMDB, but no network scan response yet.</td></tr><tr><td><strong>Transient</strong></td><td>Represents an IP that was recently active but is currently unreachable. Used to indicate unstable or intermittent hosts.</td><td>The device previously responded, but is now unreachable due to DHCP churn or intermittent connectivity.</td></tr><tr><td><strong>Yet To Scan</strong></td><td>Indicates that the Availability or Inventory scanner has not yet scanned the IP.</td><td>Newly added block/subnet where scan has not been triggered.</td></tr><tr><td><strong>Network</strong></td><td>Assigned to the network address of the subnet. This is a system-reserved IP.</td><td>10.0.4.0 in subnet 10.0.4.0/24</td></tr><tr><td><strong>Broadcast</strong></td><td>Assigned to the broadcast address of the subnet. This is a system-reserved IP.</td><td>10.0.4.255 in subnet 10.0.4.0/24</td></tr><tr><td><strong>Reclaimed</strong></td><td>Appears when an IP transitions back to the free state after being marked “In Use.” Only available if the reclamation workflow is enabled.</td><td>An IP becomes inactive and is reclaimed after cleanup rules apply.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.infraon.io/infraon-help/infinity-user-guide/ipam.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.