Technical Documentation

Importing Multiple Infranet Controllers

If your network includes a large number of devices, you can save time by adding multiple devices in a single workflow. You can add up to 4000 devices at a time to a single domain (but you cannot add multiple devices to different domains at one time).

Add multiple Infranet Controllers by following these procedures:

  1. Creating the CSV File
  2. Validating the CSV File
  3. Adding and Importing Multiple Infranet Controllers

Creating the CSV File

The CSV file defines all the required and optional values for each Infranet Controller device. Within a .csv file, you define the Infranet Controller configuration values that you want to add. The required and optional values depend not only on how the Infranet Controllers are deployed on your network but also on the device family.

Juniper Networks provides CSV templates in Microsoft Excel format for each type of CSV file. These templates are located in the utils subdirectory where you have stored the program files for the UI client. For example:

C:\Program Files\Network and Security Manager\utils

For each CSV file, each row defines a single Infranet Controller’s values for each parameter. For text files, columns are separated by commas.

Creating Infranet Controller Parameters in CSV File

For an Infranet Controller, Table 1 lists the parameters to be set in the CSV file.

Table 1: CSV File Information for Infranet Controllers

Field

Type

Required

Acceptable Values

Name

String

yes

ic-6500, ic-4500

Color

String

yes

blue, red, green, yellow, cyan, magenta, orange, pink.

OS Name

String

yes

IC

Platform

String

yes

IC-4500, IC-6500

Device Subtype

String

yes

Set to “none”

Managed OS Version

String

yes

2.2

Device Admin Name

String

yes

<administrator>

Device Admin Password

String

yes

<password>

Must be a minimum of nine characters.

Using an Excel File to Add Multiple Infranet Controllers

To edit the Excel file to add multiple Infranet Controllers:

  1. Copy and open either the bulkadd_nonreachable-sample.csv file or the bulkadd_nonreachable-DMI-sample.csv file located in C:/Program Files/Network and Security Manager/utils.
  2. Using one row for each Infranet Controller you want to add, enter the required values for each parameter that you wish to set for them. You can also provide optional values, if desired.
  3. Save the file to a location on your local drive.

Using a Text File to Add Multiple Infranet Controllers

To add multiple Infranet Controllers using a text file, create a text file with the following text:

  1. Open a text file and add the Infranet Controllers and its parameters as follows:

    Ic-6000, blue, ic, IC-6000, none, root, 2.2, netscreen

    Ic-6500, pink, ic, IC-6500, none, root, 2.2, netscreen

    Ic-4000, cyan, ic, IC-4000, none, root, 2.2, netscreen

    Ic-4500, pink, ic, IC-4500, none, root, 2.2, netscreen

  2. Save the file as a .csv file.

Validating the CSV File

When you add the Infranet Controllers, NSM validates the configuration information in the .csv file and creates a validation report. The report lists any incorrect or duplicate configurations, and indicates the exact line that contains invalid data.

Note: The validation report displays only the first error in the line. If the line contains additional errors, those errors do not appear in the validation report.

Select Cancel to quit adding multiple Infranet Controllers, or select Add Valid Devices to begin adding the Infranet Controllers for which you have provided valid device configurations.

If the validation report listed incorrect configurations, you can still select Add Valid Devices; however, only the devices with correct configurations are added. If the .csv file contains duplicate configurations, NSM ignores the duplicates.

After you have added multiple Infranet Controllers, you cannot roll back or undo your changes. To edit or delete Infranet Controllers, select the Infranet Controller in the NSM UI and make the necessary changes.

Adding and Importing Multiple Infranet Controllers

To add and import multiple Infranet Controllers in the NSM UI:

  1. From the left pane of the NSM UI, click Configure.
  2. Expand Device Manager and select Devices. The Devices workspace appears on the right side of the screen.
  3. Click the Device Tree tab, click the New button, and select Many Devices. The New-Device dialog box appears.
  4. In the New-Device dialog box:
    • Select Device is Not Reachable.
    • Specify the location of the CSV file.
    • Specify the output directory for the .cli file. For each valid device configuration that uses a dynamic IP address, NSM creates a .cli output file. By default, the .cli file is saved to the following GUI server directory:

      /usr/netscreen/GuiSvr/var/ManyDevicesOutput/<inputFile_YYYYMMDDHHMM>/

      Before the Infranet Controllers can be managed by NSM, you must enter the CLI commands in the .cli file on the physical security device.

  5. Click Next. The Add Device wizard validates the CSV file and provides a validation report.
    • Select Cancel to quit the Add Many Devices process.
    • Select Add Valid Devices to begin adding the devices for which you have provided valid device configurations.
  6. From the Choose Device Server Connections Parameter area select:
    • Use Default Device Server IP Address and Port—Connects the device to the NSM device server IP address and port.
    • Use Device Server Through MIP—Connects the NSM device server through a mapped IP address and port.
  7. Click Finish to add the Infranet Controllers.

The time it takes for NSM to activate and import the Infranet Controllers depends on the number of Infranet Controllers and the management system configuration.