Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can import DNS, DHCP, and IPAM BloxOne supports importing certain data from a supported JSON or CSV file. For more information on the supported object types of objects supported, and the import/export process, see Importing and Exporting DataSee Supported Formats for the supported file format. For information on the mandatory and optional fields, see Import Parameters.

Warning

Neither BloxOne DDI nor BloxOne Threat Defense support supports importing CSV files that were exported from NIOS. 

To view the imported objectsimport events, go to Administration -> Data Import/Export. The following information is shown for each import:

  • FilenameName: Name The name of the imported fileimport event.
  • Created by: User The user account use for importing the filedata.
  • Start time: Start time of the import. 
  • End time: End time of the import.
  • Object Type: Number and type of objects The number and object types in the imported data.
  • Status: Status The status of the import process, whether it is in progress (active), completedcomplete, or failed.
  • Error: If the import operation failed, the error log is shown with the reason for the failure is updated in the document

...

  • Sort By: Click to sort by Created by, Description, Name, Start time or Status
  • Click   to sort in ascending or descending order.
  • Enter the keyword in the Search field to search for a particular entry. 
  • Click  to filter by Name, Description, Created By, Start time or Status.
Warning

You can import DNS views and zones in the same import action. However, the import of resource records should be done as a separate import action. Importing both DNS views and zones with resource records in the same import action may result in errors. To ensure successful imports, export DNS views and zones in one export action, and resource records in another export action. You can then import both files separately to avoid errors

Complete the following steps to import data:

  1. Go to Admin -> Data Import/Export -> Data Import.
  2. Click Import
  3. Specify In the following information in the General Info tab step, specify the following:
    • Name: Specify a name for the imported import configuration. 
    • Description: Specify Enter a description.
    • Tags: Click Add to associate keys with the view and specify the following details:
      • KEY: Enter a meaningful name for the key, such as a location or a department.  
      • VALUE: Enter a value for the key such as San Jose or Accounts. To remove a tag, select the respective checkbox and click Remove to delete the associated tag. For information about tags, see /wiki/spaces/ddiadminguidensdraft/pages/11014132.
  4. Click Next.
  5. In the Select file for import step, click Select file to navigate to the JSON or CSV file.

    Edit

    Note that for a successful import, edit the file

    as per

    Click Select File. Browse to select the file and click OK

    Note
    titleNote

    using the instructions in Import Parameters before the import. 

    Before importing the JSON file, you can add entries for all objects and services except on-prem hosts. You can also modify the values for Name, Description, and Tags for all objects. You cannot add or delete on-prem hosts, but you can modify the values for Name, Description, and Tags for on-prem hosts.

  6. Choose In the Verify objects step, choose the objects to be imported in the Verify objects tab. If you do not wish to import your file does not include certain objects, clear the respective checkboxes. For example, you can choose the objects in the following categories:
    • DNS/CONFIG: Choose the DNSconfig objects to be included. For a list of parameters for the particular object see DNS (dnsconfig/dnsdata).
    • DNS/DATA: Choose the DNSData objects to be included. For a list of parameters for the particular object see DNS (dnsconfig/dnsdata).
    • IPAM/DHCP: Choose the IPAM/DHCP objects to be included. For a list of parameters for the particular object see IPAM/DHCP Objects.
    • KEYS: Choose the Keys objects to be included. 
    • ONPREM: Choose the on-prem host objects to be included. For a list of parameters for the particular object see on-prem hosts.
    • TAGGINGChoose the on-prem host objects to be included. For a list of parameters for the particular object see Tagging.
  7. Click Next
  8. Choose the type of import. Choose check boxes. Ensure that you select the correct object types that correspond to the import file that you plan to use. For example, if your JSON or CSV file contains data for authoritative zones, select only the Authoritative Zones check box. 
  9. Click Next
  10. In the Select import type step, choose one of the following options:
    • Add new records from the imported file
    • Add new records and update existing records
    • Add new records, update existing records and delete all records not in the imported file
    • Add new records and delete all records not in the imported file
    • Update existing records and delete all records not in the imorted file
    • Use the Delete all records not in the imported file option

      Delete all records not in the imported file

      Warning
      titleWarning

      : Use this option with caution. If you use this option, it could result in the deletion of a large number of objects from the Cloud Services Portal, which would

      then have to be recovered

      result in having to recover them from the /wiki/spaces/ddiadminguidensdraft/pages/11012252

    •  You

      Delete all records in the imported file

      Note
      titleNote

      : You cannot add or delete on-prem hosts, but you can update the values for Name, Description, and Tags for on-prem hosts. Adding or deleting

      of  On-Prem Hostconfig 

      of the on-prem hostconfig object is not supported. 

  11. Click Next
  12. Specify the error handling. Choose In the Specify import type step, choose one of the following options:
    • Skip failed records (continue import)
    • Stop import if any record fails
  13. Click Next and verify the summary. 
  14. Click Start Import
Note
titleNote

This feature is limited to a maximum of 35K objects that can be imported at a time.  On average, 35K objects translates to an import file of approximately 50 MB in size.

Warning
You can import DNS views and zones in the same import action. But, the import of resource records should be done as a separate import action. Importing both DNS views and zones with resource records in the same import action may result in errors. To ensure successful imports, export DNS views and zones in one export action, and resource records in another export action. You can then import both files separately to avoid errors.