IPAM Lists Management - Overview

IPAM Lists Management is accessed from the Admin section, under the IPAM Admin tab.

Through this area, admin users can update IPAM tags, IPAM Regions, IPv4 / IPv6 subnets, IPAM Rules, Numbering Authority, and IPAM / VLAN Columns. 

Add / Edit IPAM Tags

When you are applying properties to IP blocks, you have the option to edit tags. IPAM Tags are used in a number of areas and can be added or edited from this screen. 

To add a new IPAM tag, type the desired name value for the new tag in the box at the top of the Edit IPAM Tags page and click "Add".

To edit a tag, simply type your changes in to the text box with the tag name.

To reorder the tag list, click and hold on the "list" icon (three lines) to the left of the tag name, then drag to the desired location in the list and release. You can also click the "Sort Alphabetically" button at the top.

To delete a tag, click on the red "Delete" button to the right of the tag name. 

When complete, be sure to click on the "Save Changes" button to save your changes. 

Add / Edit Regions

If enabled, Regions can function as a way to further define your network segments (regional tie-downs, etc.). This gives you flexibility for allocations and assignments beyond simply using Tags. Regions are used by the IPAM Gadget, the IPAM Manage UI, and IPAM Map View.

Access IPAM regions from IPAM Admin → Edit IPAM Regions. 

The Regions display includes fields for Region Code, Name, and Address.

• 'Region Code' is the shorthand name that will show in the IPAM Gadget and IPAM Manage screens.
• 'Name' is the long form name value that will be written to the database, used for API calls, and is also used for some filter selectors.
• The 'Address' field is used by IPAM map view (via Geocode API) to geolocate aggregates with that assigned region. Address may be in the form of a City / State / Country, a full street address, a company name, or other search term that the Geocode API can return a location for. The more accurate your address information, the more accurate map view will be with your aggregate locations. To use regions, you will need to apply a Geocode API Key. An "address" value that appears invalid will display a yellow warning symbol.

Applying a Geocoding API Key:

Managing Regions

To add a new Region item, click the "Add Region" button at the top of the screen. 

In the form that appears, type in a new Region Code, Name, and Address into the empty fields and click "Save". 

The new Region will be added to the Region list.

To sort the regions list, click on a column header to sort by Region Code or Name.

To edit a region, right click on the row and select "Edit" from the Action Menu. This will bring up the edit modal. Input your desired changes, then click "Save". 

To delete a single region, select "Delete" from the the Action Menu (gear icon).

To delete multiple regions, select the regions to delete by clicking the checkboxes at left. Then, click on the "Actions" menu at the top of the list and select "Delete All". 

You may also right click on the selected items to open a context menu to either "Unselected all" or "Delete all". 

Valid / Invalid Regions

Valid addresses will show a check mark in the "Location Status" field, invalid/empty addresses (unable to be mapped) will show a yellow exclamation point. When adding or editing a region, click the "Check Address" button at the lower left of the modal to check the validity of an address.

Fill Empty Region Locations

To quickly fill empty addresses for multiple regions, select "Fill Empty Locations" from the "Actions" menu at the top of the Regions list. This will fill the addresses based on their supplied "Name" value.

Region Resource Generation

Optionally, users may generate a resource entry for a region, in order to associate items such as contacts, notes, linked resources, or fields with that region. 

Clicking on a region link from IPAM Manage will automatically generate a resource entry for that region, under the "SystemRegion" section. 

The (non-editable) SystemRegion section includes the following Gadgets: Resource View, IPAMv2, Contacts, Resource Linkage, Notes, Document Storage, and Fields. 

Users may then use those Gadgets on the region resource to associate contacts, notes, custom fields, or other information to that region.

Add / Edit IPv4 / IPv6 Subnet Dropdowns

When assigning blocks using the "Smart Assign" function in the IPAM Gadget, the user has an option to assign an IP resource by allocation size. Assignments down to a single host level (/32 for IPv4, /128 for IPv6) are supported.

To add a new Subnet item, click on "Add Item" at the top of the Edit List: IPv4 or IPv6 Subnets page. 

After adding a new item, it will show at the bottom of the list. Hit "Save Changes" to save your changes. 

To edit a subnet, simply type your changes in to the text box. Remember to click "Save Changes" before exiting.

To reorder the subnet list, click and hold on the "list" icon (three lines) to the left of the subnet, then drag to the desired location in the list and release. 

After adding or editing a subnet, you may wish to clean up the list order by hitting "Sort Numerically" at the top of the page to reset the list order, including the new entry. 

To delete a subnet, click on the red "Delete" button to the right of the subnet entry. 

When complete, be sure to click on the "Save" button to save your changes. 

Edit IPAM Rules

IPAM Rules allow for certain address positions within an IP Block to be reserved when utilizing Direct Assign and Smart Assign.

These rulesets may be managed in the "Edit IPAM Rules" section of IPAM Admin. 

For additional details, see IPAM Rules.

Numbering Authority

Numbering Authority allows Admin users to configure domain sets of values, for use with associated functions or external number tracking.

With Numbering Authority, you can create new numbering domains, track which values have been handed out, free values no longer in use, generate the next sequence value, and associate keys-value pairs to a number value. Numbering Domains may be used with APIv2 to generate numbers for use within ProVision instances or custom applications.

Available Domain Types

Six numbering domain types are available in Numbering Authority: Sequential, Multi-Range, Meta Multi-range, UIUDv4, IPv6 Sparse Allocation, and Meta IPv6. 

Sequential:

Provides a sequential number domain starting with '0' and progressing in numerical order.  Potential Applications: Ticketing Queues, Customer Numbers

Multi-Range:

User-defined numbers and number ranges (e.g.: 2-3,4-6, 25, 27-28) to include or exclude as available.  Potential Applications: VLANs

Meta Multi-Range:

The Meta Multi-range numbering type is similar to Multi-range, but includes additional options to specify the ordering sequence.

Users define individual numbers and number ranges (e.g.: 2-3,4-6, 25, 27-28) to include or exclude as available, and then may also specify a Selection name and algorithm to specify the order. 

UIUD v4:

Generates a Universally Unique Identifier according to v4 (Random) standard.  Potential Applications: Unique Identifiers

IPv6 Sparse Allocate:

Determines the next IPv6 block to assign to evenly distribute assignments throughout the provided range. Used with the IPAM IPv6 Aggregate Sparse Allocate function. See: Working with IP Aggregates . Applications: IPv6 Sparse Allocation

Meta IPv6:

The Meta IPv6 numbering type generates the next IPv6 block of the specified mask from a larger aggregate. Users may specify a Selection name and algorithm to specify the order (forwards/backwards).

Optionally, new sub numbering domains may be created automatically at each number generation in order to generate assignment blocks for hierarchical IPv6 relationships.

Working with Numbering Domains

See below for additional information on creating Numbering Domains and using domain actions.

Edit IPAM or VLAN Columns

The Edit IPAM Columns and Edit VLAN Columns pages lets you change the order, column name, and visibility of IPAM / VLAN columns globally for IPAM / VLAN areas, respectively.

Editing IPAM Columns will affect the order, name, and visibility of columns in IPAM Manage and the IPAM Gadget, and the available fields in Edit Block for both VLAN and IPAM. 

Editing VLAN columns will affect the order, name, and visibility of columns in VLAN Manage, VLAN Advanced, and the available fields in Edit Domain / Edit VLAN.

Additionally, for both IPAM and VLAN, any disabled fields will not be filterable or accessible in IPAM / VLAN Reports.

Eleven default fields and ten user-defined "Metadata" fields are available for customization.

To edit a column name, simply type your changes into the text box. and click the "Save Changes" button.

To reorder the columns, click and hold on the "list" icon (three lines) to the left of the subnet, then drag to the desired location in the list and release. 

To toggle visibility for a column, click the eye icon to the right of the column name to enable / disable visibility.

This shows or hides the column in both IPAM Manage and the IPAM Gadget, and affects all users.

When complete, be sure to click on the "Save Changes" button to save your changes. 

Adding Constraints to IPAM Columns

The Constraints system allows for custom field validation and field restrictions to be created for IPAM fields. The applied constraint may be anything from a numerical comparison operation,  a check against a pre-determined text string, ensuring selections from a pre-set list, or forcing entries into a specific format, such as IPv4/IPv6, phone number, or RegEx. For more detail on available types of constraints and creating them see the Constraints section.

A column that may have a constraint applied will have a checkmark icon in the "Options" column. Click the icon and select a constraint from the dropdown.

Click "Save".

The applied constraint name will then be displayed in the column row.

Click "Save Changes" before exiting the IPAM Column page to retain changes.

Additional Information

Continue on to the following pages for additional information on IPAM Admin tasks:

• IPAM Rules
• Holding Tank Management
• LIR Management and Use
• Constraints

For additional information on non-admin IPAM areas, see:

• IPAM Tab