Exporting device adapters


This topic provides instructions on exporting a device adapter.

To learn about the states of a device adapter and various types of device adapters available in TrueSight Network Automation, see Managing-device-adapters.

Exporting a device adapter produces an XML file that you can analyze, modify, or import to another Network Automation system.

To export a device adapter, you can choose between the following methods:

  • Export a single device adapter to an XML file
  • Export multiple device adapters at once, saving all adapters into one XML file
     Exporting all your adapters to a single file makes it easy to forward them to BMC customer support for analysis.

Exporting a single device adapter

Log on to the application with a user having administrator privileges on the Network Automation server, and on the Admin > Network Admin > Device Adapters page, do the following:

  1. Locate the external script action, device type, configuration trail, or custom action in the hierarchy as shown in the following figure:

    DeviceAdpaterListing.png

     

  2. Click the Export icon Icon_Export.png in the Actions column of the device adapter that you want to export.
  3. If the adapter is modified, a pop-up window is displayed. Click the Export icon Icon_Export.pngfor the version you want to export:
    ExportOptions.png
    • Baseline Content: The current baseline version of the adapter code. The baseline contains the code as shipped by BMC. The baseline can change when you upgrade the software to reflect enhancements and corrections.
    • Modified Content: The latest modified version containing your customizations, which the Network Automation system is currently running.
    • Previous Baseline Content: The baseline version that is installed at the time of the latest modification. This option is inactive if this version is not different from the current baseline version. Use this option after a software upgrade to help identify changes made by BMC to the shipped baseline version (compare baseline versus previous baseline) as opposed to changes you made (compare modified versus previous baseline). You should incorporate BMC's changes into your modified version to capture enhancements and corrections.
    • All Contents: Generates a .zip file containing baseline, modified, and previous baseline versions for comparison purposes.
  4. In the download dialog box, click Save and select a location for the file.
    The downloaded XML file contains the following information in a <comment> tag:
    • Network Automation Server version
    • Exported date
    • Enabled (Yes or No)
    • State (New, Baseline, or Modified)
    • Requires Merge (Yes or No)
    • Last Modified (date and user, only for modified adapters)
    • Annotation

Export multiple device adapters

Log on to the application with a user having administrator privileges on the Network Automation server, and on the Admin > Network Admin > Device Adapters page, click Export Button_Export.pngand do the following:

  1. Select one of the options from the pop-up menu:

    • Active Contents For Enabled Adapters: Exports what your system is actively using when performing device actions.
    • Baseline Contents For All Adapters: Exports the original shipped content.
    • All Contents For Modified Adapters: Exports shipped content that you have changed.
    • All New Adapters: Exports adapters you have added.

    The selected contents are exported to a single XML file.

  2. Save the file.

Related topics

Importing-device-adapters
Modifying-device-adapters

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*