Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added Step by step simple import instructions w screenshots, updated sample files to those used in how-to

...

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 Simple ZIP zones.zip

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

...

Note

To successfully map to a DNS server, that server must already exist within Provision.

...

For a sample CSV config.csv

 

Importing your DNS Zones

Step 1: Create a new DNS Import Job  

Navigate to the Data Import Tab from the Admin button to import your data. Select "BIND Zone Upload/Import" under "DNS Import".

Image Added

Create a Job Name and Description for the import. This is especially useful to keep track of progress in cases the data arrives from multiple sources, or will require multiple stages of manual review. Select the appropriate Configuration File (required), Archive File (required), and CSV File (optional) that you prepared above by selecting the "Choose File" button(s) under each section, and browsing to the correct file location. Then hit "Start Import".

Image Added

 

Note
titleWorking with Large or Multiple Data Sets

Although you cannot add new files to an existing job, for jobs with multiple sources for data (which may have different formatting), you can simply create separate jobs and descriptions for each source - no need to manually combine the data into one file before importing. The Import tool's mapping and editing functions will allow for the data to be reconciled in Provision.

For large data sets where multiple stages of manual review might be needed, you can create a new job using the same set of data files in order to work in parallel on a different portion of the data.

 

After importing, the new job will appear under the "Existing Jobs" section. To continue working with this job, select it from the list and the next step will appear on the page.

Image Added


Step 2: Map Data Columns (Optional)

If you chose to load an optional match CSV file to assign DNS Zones to Resource, a mapping step will be available. Otherwise, proceed to Step 3: Reviewing Data.

For DNS imports, four column definitions are available: Zone, Resource ID, Server Master IP, and Server Slave IP. Using the dropdown menu, select the appropriate definition for each of the imported columns. Zone and Resource Holder ID should each only have a single column selected, however, any number of columns may be defined as Server Master IP or Server Slave IP. Other columns which do not apply under the available definitions should be left as blank, and will be skipped during the upload process. 

When completed, hit "Next".

Image Added

Step 3: Reviewing Data

After supplying the file set and defining columns (if applicable), a review step is provided. The configuration file is broken into individual jobs, scanned for errors, and shown by row (in batches of 100) to be reviewed. Zones with errors will show as color coded. and can be filtered to be viewed by All, Valid, Warnings, Invalid, or Ignored. From here, the zone can be edited or ignored. 

Image Added

 

Editing the zone provides options to alter the Resource Holder, enable DNS servers, and redefine Master and Slaves.

After editing, hit "Save", and continue reviewing / editing data as desired. 

Image Added

When the review step is completed, hit the "Execute Import" button. A progress bar will appear to show progress and note errors if they occur.

When the bar reaches 100%, the import is complete.

Image Added