Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 8.3.0

Importing DNS Zones

ProVision offers multiple DNS zone import options, available under the Data Import tab in the the Admin section. Additional Import options may be available on zone or server pages.


Image Added

DNS Global Import Options

ProVision offers various DNS zone import options available under the Data Import tab in the the Admin section:


BIND Zone Import

  • Imports using the

When it comes to importing your DNS zones, the simplest way is using the BIND zone import function built into ProVision. Below, you can also download "sample" files if you wish for examples.

Preparing your DNS Zones for Import

If your zone data is currently in BIND format - this is very straightforward.

There are three components to the upload process:

...

  • named.conf configuration file tied to the zones you are uploading

...

This tells the importer the Zone Name and where the zone file is written. It could be as simple as a multi-line file:

Code Block
titleSimple DNS Config File
zone "my-zone.com" { type master; file "my-zone.com.zone"; };
zone "my-other-zone.com" { type master; file "my-other-zone.com.zone"; };
zone "my-third-zone.com" { type master; file "my-third-zone.com.zone"; };

or could be more complex like this file structure directory:

Code Block
titleComplex DNS Config File
zone "my-zone.com" { type master; file "/usr/local/zones/my-zone.com.zone"; };
zone "my-other-zone.com" { type master; file "/usr/local/zones/more/my-other-zone.com.zone"; };
zone "my-third-zone.com" { type master; file "/usr/local/zones/more/even more/my-third-zone.com.zone"; };

For a sample Simple Config conf.conf

2) A ZIP or TAR file of the DNS zones themselves (required)

This is as it sounds - a file archive where we can find the zones and it should match the configuration file uploaded in Step 1.

Note
titleZone Order

These zone files can be in any order, or in sub-directories, so long as the configuration file (Step 1) correctly points to them

For a sample ZIP zones.zip

3) Match CSV for assigning DNS Zones to Resources (optional)

This file allows the administrator to "assign" zone files to a given Resource. If you have Imported a group of Resources, they have Resource IDs associated with them. You can then import DNS zones and assign them to those Resource IDs. When complete, you will be able to pull up the Resource Record and see the DNS Zones associated to that Resource ID.

Code Block
titleSample CSV File
my-zone.com,test-01,fun stuff, 174.23.14.4, 174.23.14.9
my-otherzone.com,test-02,great stuff, dns1.dns.net, dns2.dns.net
even-reverse-zones.arpa,test-03,amazing stuff

Note the columns are the "Zone Name", the "Resource ID", "Notes", "Master Server", "Slave Server"

Info
titleImporting DNS Server Linkages

When importing zones, you can use the "Master Server" and "Slave Server" columns to assign zones to specified DNS Servers. Please note that the IP address or FQDN of the DNS Server is supported in this field.

 

  • , a .zip or .tar file of the zones themselves, and an optional .csv file mapping zones to customers.

PowerDNS Zone Import 

  • Option is available after configuring a PowerDNS server with a MySQL backend.  Connects to the selected server and imports all zones.

InfoBlox Zone Import 

  • Imports DNS zones using a provided Host, Username, and Password. The InfoBlox import pulls all zones on the InfoBlox LOCAL grid and adds them to a designated Group. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records.

NS One Zone Import

  •  Imports DNS zones using a NS One API Key. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records. 

Dyn DNS Zone Import

  • Imports DNS zones using a Dyn DNS Customer Name, Username, and Password. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records. 

DNSMadeEasy Zone Import

  • Imports DNS zones using a DNSMadeEasy API Key and API Secret. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records. 

IPPlan Zone Import

  • Imports DNS zones using IPPlan MySQL database options. It is advised to create a DNS Group prior to the import with default parameters and NS records to be inherited by the imported records. 

3rd Party Zone Check

The DNS Import Check is accessible from the Admin Section --> Data Import Tab.

Image Added

Expand

Select an existing zone from the dropdown and upload a .zone file. Click the "Compare" button to start the process.

Image Added

The resulting comparison will verify the zone matches the uploaded file or highlight differences found between the two.

Image Added


Additional DNS import options may be available on a per-zone or per-server level, accessed from the DNS Tab:

DNS Zone Import Options (Individual)

DNS Zone / Record Import:

  • This tool is available on a zone's "View Zone" page, and allows the user to import additional zone/record information into an existing ProVision zone by uploading a zone file (.zone). 


    Expand

    Import Zone / Import Records

    A  zone file (.zone) may be imported into a ProVision zone to populate record data. Note: To import the record data, the zone must already exist in ProVision - although it may be an empty placeholder zone if necessary.

    Enable Saving Import Files (Admin Setting - Optional)

    Before you import a zone file, you may (optionally) select to save the import file to the zone. Saving the file allows you to later re-download it directly from ProVision.

    To enable saving import files, go to Admin Preferences → DNS Settings sub-tab. From there, select "Import Settings" in the DNS Global Settings module. 

    Image Added

    Toggle "Keep Import File" into the ON position, then select "Save Changes". 

    Import Zone File

    To import a zone file to populate record data in ProVision, go to the View Zone page for the zone. The zone must already exist in ProVision, although it may be empty

    Click "Import Zone" on the View Zone page. 

    Image Added

    A Zone Import dialog box will open. Next to Zone File:, click "Choose File" and select your .zone file to import. Then, select an import policy to follow.

    Image Added

    When done, Click "Import Zone". 

    Importing Zone file with Comments

    DNS Zone Import will also import comments contained in the .zone file, such as an internal change log (as seen in the image below).

    Image Added

    During import, these comments are added to ProVision's zone comments field:

    Image Added



Additional Information

Continue to the following sections for details on performing each import method:

Children Display
alltrue
For a sample CSV config.csv