Importing devices from Entuity Network Analytics

Single-step device import into TrueSight Network Automation

The following steps describes how to configure a single-step import of devices from Entuity Network Analytics to Network Automation where devices are imported into Network Automation via an automatic export from Entuity Network Analytics.

1. Log in to Network Automation with a user that has an administrator role.
2. Open the Device Import Tasks page by navigating to Admin > Network Admin > Device Import.
3. Open the Add Device Import Task page by clicking Add in the menu.
4. Enter a value for the Name field, for example, Entuity Import.
5. (Optional) Enter a value for the Annotation field.
6. Leave the Enabled option selected.
7. Ensure that the Auto Purge and Initial Snapshot options are not selected.
8. In the Format field, select Entuity Network Analytics XML Format.

9. In the Source field, paste the following URL:

   http://<entuityServer>:<entuityWebport>/EOS/cgi/GenerateReport?noCreate=1&of=xml&DeviceEx.filter=all&DeviceEx.attr=id%2Cname%2CdevPolledIpAddr%2CsysOid&DeviceEx.attr.1=%23entuity_server_info()%5B0%5D%23%2C%22serverId%22%2C%22displayType%3Dstring%22&login=<userName>:<password>

   You can use the following special characters: !@#$^*()-_+[]{}|;:'",./`~\<>. However, you cannot use the following special characters: % = & ?.

   Important

   • You can set a password of maximum 32 characters.
   • If you want to change the value of any query parameter, then you need to replace the entire parameter value (unencrypted). For example, if you want to change the password, then you need to change entire value of the login parameter, that is, <username>:<password>. Only changing the password will not work.

   For <entuityServer> and <entuityWebport>, substitute the IP address or server name and web port on which Entuity Network Analytics is running. For <userName>:<password> substitute the logon credentials.

10. Set the value in the Repeat field:
    • To do a single import, set it to Import Once.
    • To automate the import process, set it to Import Daily, Import Weekly, or Import Monthly.
11. Ensure that the Import Time is set to Now.
12. Ensure that Dynamic Menu Fields is set to Accept Unknown Values.
13. Ensure that Scope is set to All Devices from the Import Source.
14. Click Save.
15. Check the Execution Status for this task in the Device Import Task list.
    You can Refresh this screen to see the updates. Clicking Successful displays the list of devices that were imported.

_{Back to top}

Multi-step device import into TrueSight Network Automation

This section describes how to configure a multi-step import of devices from Entuity Network Analytics to Network Automation where the devices are exported from Entuity Network Analytics, and then Network Automation imports the exported device information.

To export devices from Entuity Network Analytics

The command line interface is ideal for automating the Entuity Network Analytics export process using the scheduling utility in the OS (that is, Microsoft Windows Scheduler or UNIX cron).

1. Copy the EmprisaFormat.txt file from BCAN_HOME\public\entuity to ENA_INSTALL\lib\httpd\EOS\cgi.
2. Run the following commands by substituting the paths and Entuity Network Analytics logon credentials accordingly:
   
   C:\> cd ENA_INSTALL\lib\httpd\EOS\cgi
   ENA_INSTALL\lib\httpd\EOS\cgi> GenerateReport.exe login=<userName>:<password> -r <EmprisaFormat.txt> <fileName>.xml
   Replace <userName>:<password> with the Entuity Network Analytics logon credentials. Replace <fileName> with the export file name. Keep <EmprisaFormat.txt> intact.
   
   For example:
   ENA_INSTALL\lib\httpd\EOS\cgi> GenerateReport.exe login=ena01:password123 -r <EmprisaFormat.txt> enaExport.xml
3. Copy or transfer the enaExport.xml file from ENA_INSTALL\lib\httpd\EOS\cgi to BCAN_DATA\devices.

_{Back to top}

To import devices into Network Automation

1. Log on to Network Automation with a user that has an administrator role.
2. Open the Device Import Tasks page by navigating to Admin > Network Admin > Device Import.
3. Open the Add Device Import Task page by clicking Add in the menu.
4. Enter a value for the Name field, for example, Entuity Import.
5. (Optional) Enter a value for the Annotation field.
6. Leave the Enabled option selected.
7. Ensure that the Auto Purge and Initial Snapshot options are not selected.
8. In the Format field, select Entuity Network Analytics XML Format.
9. In the Source field, enter a path and file name that match the export file you previously generated.
   
   For example: BCAN_DATA\devices\enaExport.xml
10. Set the value in the Repeat field:
    • To do a single import, set it to Import Once.

    • To automate the import process, set it to Import Daily, Import Weekly, or Import Monthly.
      
      

      Note

      Schedule the import to occur just after each scheduled export from Entuity Network Analytics.

11. Ensure that the Import Time is set to Now.
12. Ensure that Dynamic Menu Fields is set to Accept Unknown Values.
13. Ensure that Scope is set to All Devices from the Import Source.
14. Click Save.
15. Check the Execution Status for this task in the Device Import Task list.
    You can Refresh this screen to see the updates. Clicking Successful displays the list of devices that were imported.

_{Back to top}

Importing Entuity Network Analytics views and synchronizing with TrueSight Network Automation Auto-Groups

The following steps describe how to import Entuity Network Analytics Views into Network Automation.

1. Create a Network Automation multi-select dynamic field called Views by doing the following:
   1. Log on to Network Automation with a user that has an administrator role.
   2. Open the Dynamic Fields page by navigating to Admin > System Admin > Dynamic Fields.
   3. Open the Add Dynamic Field page by clicking Add in the menu.
   4. Leave the Component field set to Device.
   5. Leave the Assignment Mechanism field set to User Assigned.
   6. Set the Value Type field set to Multi Select Menu.
   7. In the Name field, enter Views.
   8. At a minimum, enable the Auto-Group option.
      
      This causes Network Automation to group by Entuity Network Analytics Views. You can choose to enable some of the other options later.
   9. Add at least one value to the Options field (that is, "N/A" for Not Assigned). 
      Optionally, you can add all of your possible Views options, or you can have Network Automation populate the values automatically at import time.
   10. Click Save.
2. If you are using the single-step import method, follow the instructions in Single-step device import into TrueSight Network Automation, but note the following:
   
   • For the Source field, copy the following URL and paste.
     
     http://<entuityServer>:<entuityWebport>/EOS/cgi/GenerateReport?noCreate=1&of=xml&DeviceEx.filter=all&DeviceEx.attr=id%2Cname%2CdevPolledIpAddr%2CsysOid&DeviceEx.attr.1=%23entuity_server_info()%5B0%5D%23%2C%22serverId%22%2C%22displayType%3Dstring%22&login=<userName>:<password>
     
     For <entuityServer> and <entuityWebport>, substitute the IP address or server name and web port where Entuity Network Analytics is running. Also, for <userName>:<password> substitute the logon credentials.
   • When defining the device import task, leave Dynamic Menu Fields set to Accept Unknown Values, if you want Network Automation to discover and build out the Views automatically. If this field is set to Reject Unknown Values, Network Automation only imports Views that you defined as menu options in the Views dynamic field.
3. If you are using the multi-step import method, follow the instructions in Multi-step device import into TrueSight Network Automation, but note the following:
   
   • Instead of copying EmprisaFormat.txt, copy the file, EmprisaFormatViews.txt, from BCAN_HOME\public\entuity to ENA_INSTALL\lib\httpd\EOS\cgi.
   • When defining the device import task, leave Dynamic Menu Fields set to Accept Unknown Values if you want Network Automation to discover and build out the Views automatically. If this field is set to Reject Unknown Values, Network Automation only imports Views that you defined as menu options in the Views dynamic field.

_{Back to top}