Fortinet white logo
Fortinet white logo

Administration Guide

Importing and exporting device lists

Importing and exporting device lists

Using the Import Device List and Export Device List option, you can import or export a large number of devices, ADOMs, device VDOMs, and device groups. The device list is a compressed text file in JSON format.

You can also use the Export to CSV option to export a device list to CSV format. However, you cannot use the CSV format to import a device list to FortiManager. You can only import a device list that was exported to JSON format.

Advanced configuration settings such as dynamic interface bindings are not part of import/export device lists. Use the backup/restore function to backup the FortiManager configuration.

The Import and Export Device List features are disabled by default. To enable, go to System Settings > Admin > Admin Settings, and select the Show Device List Import/Export checkbox under Display Options on GUI.

Proper logging must be implemented when importing a list. If any add or discovery operation fails, there must be appropriate event logs generated so you can trace what occurred.

To export a device list to compressed JSON format:
  1. Go to Device Manager > Device & Groups.
  2. Select a device group, such as Managed FortiGates.
  3. From the More menu, select Export Device List.

    The Choose ADOM dialog box is displayed.

  4. Click Current ADOM to export the device list from the current ADOM, or click All ADOM to export the device list from all ADOMs.

    A device list in JSON format is exported in a compressed file (device_list.dat).

To export a device list to CSV format:
  1. Go to Device Manager > Device & Groups.
  2. Select a device group, such as Managed FortiGates.
  3. From the More menu, select Export to CSV.

    The Export to CSV dialog box is displayed.

  4. (Optional) Change the file name.
  5. Select whether to export all columns or only customized columns.
  6. Click Download.
To import a device list:
  1. Go to Device Manager > Device & Groups.
  2. Select a device group, such as Managed FortiGates.
  3. From the More menu, select Import Device List.
  4. Click Browse and locate the compressed device list file (device_list.dat) that you exported from FortiManager, or drag and drop the file onto the dialog box.
  5. Click OK.

Importing and exporting device lists

Importing and exporting device lists

Using the Import Device List and Export Device List option, you can import or export a large number of devices, ADOMs, device VDOMs, and device groups. The device list is a compressed text file in JSON format.

You can also use the Export to CSV option to export a device list to CSV format. However, you cannot use the CSV format to import a device list to FortiManager. You can only import a device list that was exported to JSON format.

Advanced configuration settings such as dynamic interface bindings are not part of import/export device lists. Use the backup/restore function to backup the FortiManager configuration.

The Import and Export Device List features are disabled by default. To enable, go to System Settings > Admin > Admin Settings, and select the Show Device List Import/Export checkbox under Display Options on GUI.

Proper logging must be implemented when importing a list. If any add or discovery operation fails, there must be appropriate event logs generated so you can trace what occurred.

To export a device list to compressed JSON format:
  1. Go to Device Manager > Device & Groups.
  2. Select a device group, such as Managed FortiGates.
  3. From the More menu, select Export Device List.

    The Choose ADOM dialog box is displayed.

  4. Click Current ADOM to export the device list from the current ADOM, or click All ADOM to export the device list from all ADOMs.

    A device list in JSON format is exported in a compressed file (device_list.dat).

To export a device list to CSV format:
  1. Go to Device Manager > Device & Groups.
  2. Select a device group, such as Managed FortiGates.
  3. From the More menu, select Export to CSV.

    The Export to CSV dialog box is displayed.

  4. (Optional) Change the file name.
  5. Select whether to export all columns or only customized columns.
  6. Click Download.
To import a device list:
  1. Go to Device Manager > Device & Groups.
  2. Select a device group, such as Managed FortiGates.
  3. From the More menu, select Import Device List.
  4. Click Browse and locate the compressed device list file (device_list.dat) that you exported from FortiManager, or drag and drop the file onto the dialog box.
  5. Click OK.