Importing devices from Entuity

BMC Network Automation can import devices from Entuity on a scheduled or on-demand basis by using a single step process, which BMC recommends, or a two-step process. This topic includes the following sections:

• Single-step device import into BMC Network Automation
• Multi-step device import into BMC Network Automation
• Importing Entuity views and synchronizing with BMC Network Automation Auto-Groups
• Related topics

Single-step device import into BMC Network Automation

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

1. Log in to BMC 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 Eye of the Storm 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>
   
    For <entuityServer> and <entuityWebport>, substitute the IP address or server name and web port on which Entuity 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 BMC Network Automation

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

To export devices from Entuity

The command line interface is ideal for automating the Entuity 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 EYE_INSTALL\lib\httpd\EOS\cgi.
2. Run the following commands by substituting the paths and Entuity logon credentials accordingly:
   
   C:\> cd EYE_INSTALL\lib\httpd\EOS\cgi
   EYE_INSTALL\lib\httpd\EOS\cgi> GenerateReport.exe login=<userName>:<password> -r EmprisaFormat.txt EntuityExport.xml
3. Copy or transfer the EntuityExport.xml file from EYE_INSTALL\lib\httpd\EOS\cgi to BCAN_DATA\devices.

_{Back to top}

To import devices into BMC Network Automation

1. Log on to BMC 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 Eye of the Storm 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\EntuityExport.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.
      
      

      Warning

      Note

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

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 views and synchronizing with BMC Network Automation Auto-Groups

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

1. Create a BMC Network Automation multi-select dynamic field called Views by doing the following:
   1. Log on to BMC 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 BMC Network Automation to group by Entuity 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 BMC 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 BMC 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 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 BMC Network Automation to discover and build out the Views automatically. If this field is set to Reject Unknown Values, BMC 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 BMC Network Automation, but note the following:
   
   • Instead of copying EmprisaFormat.txt, copy the file, EmprisaFormatViews.txt, from BCAN_HOME\public\entuity to EYE_INSTALL\lib\httpd\EOS\cgi.
   • When defining the device import task, leave Dynamic Menu Fields set to Accept Unknown Values if you want BMC Network Automation to discover and build out the Views automatically. If this field is set to Reject Unknown Values, BMC Network Automation only imports Views that you defined as menu options in the Views dynamic field.

_{Back to top}

Related topics

Adding-a-file-access-device-import-task
Adding-dynamic-fields