×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')

Important

   

This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.
TrueSight Network Automation 8.9 ... Integrating Third-party management systems Entuity Network Analytics

Importing devices from Entuity Network Analytics

TrueSight Network Automation can import devices from Entuity Network Analytics 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 TrueSight Network Automation

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

  1. Log in to TrueSight 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  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 TrueSight Network Automation where the devices are exported from Entuity Network Analytics, and then TrueSight 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 TrueSight Network Automation

  1. Log on to TrueSight 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\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 TrueSight Network Automation.

  1. Create a TrueSight Network Automation multi-select dynamic field called Views by doing the following:
    1. Log on to TrueSight 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 TrueSight 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 TrueSight 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 TrueSight Network Automation to discover and build out the Views automatically. If this field is set to Reject Unknown Values, TrueSight 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 TrueSight Network Automation to discover and build out the Views automatically. If this field is set to Reject Unknown Values, TrueSight 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

Was this page helpful? Yes No Submitting... Thank you
Last modified by Sulekha Gulati on Mar 03, 2020
devices eye_of_the_storm entuity import single_step multi_step

Comments

Log in or register to comment.

Adding external links and dynamic fields in TrueSight Network Automation
Configuring and operating Entuity Network Analytics extensible menus for TrueSight Network Automation
© Copyright 2013 - 2019 BMC Software, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.