Importing IP addresses - User Guide - BlueCat Horizon

BlueCat Horizon User Guide

ft:locale
en-US
Product name
BlueCat Horizon

To import IP addresses, you can either open the Import data wizard from within a specific network in the list, or from the Networks tab of the IPAM page, where networks can be imported using the same wizard. Refer to Importing IPAM data for instructions.

In the Import data wizard, you can import IP address information with the following options:

  • Set properties
  • Add/replace DNS hosts
  • Clear properties

Refer to the examples below to view the required format for each of these options.

When importing IP addresses into DDI orchestrator, the columns and fields should be formatted as follows:

IP address column

To specify which IP addresses to import, include a column with the header labeled as IP Address, IPAddress, IP, IP-Address, or Name. In this column, enter the IP addresses you want to import.

Built-in fields

There are a couple of built-in fields for IP address imports. Format the built-in fields as follows:

  • Claimed?: Identified in header line by “Claimed” and “is_Claimed”.

    If set to Yes, the IP is claimed permanently. If set to No, any claims are waived.

  • DNS hosts: Identified in header line by “DNS Hosts” or “DNS Records”. The name can be singular or plural, and the space between the words can also be removed or replaced with _.

    The column should be a list of fully qualified hostnames that should be added to or removed from the IP, space- or comma-separated. To remove specific hostnames, prefix the hostname with a hyphen -. To clear all DNS records from the IP, use the value “$null” or “%clear”. Otherwise, the hostnames are added to the IP if they don’t already exist. As a result, these DNS records are created in the appropriate DNS zones during the import.

Custom fields

The same formatting rules apply to custom fields for IP addresses as do built-in fields. All custom properties defined for IP addresses can be imported.

Examples

It's important to format the import data correctly. To read the general formatting guidelines, refer to Formatting the IPAM data for import. The following examples display the data format needed to import IP address information into DDI orchestrator:

Example 1: Update IP address information

This example updates information on two IP addresses.

IP, Responsible Person
1.2.3.10, Jon
1.2.4.11, Snow

Example 2: Clearing properties

This example clears the Responsible Person property on two IP addresses.

IP, Responsible Person
1.2.3.10, $null
1.2.4.11, $null

Example 3: Adding DNS records to IP addresses

This example adds DNS records to two IP addresses, and clears them from the third.

IP, DNS Hosts
1.2.3.10, hostname.company.com hostname.company2.com
1.2.4.11, -hostname2.comany.com hostname3.company.com
1.2.4.12, $null