Adding a configuration export task

This topic provides instructions on adding and viewing a configuration export task. You can export configurations for snapshot purposes or for use by another application (for example, modeling tools). The configuration is exported in ASCII format as received from the device. Multiple export tasks are queued to run once or on a recurring basis.

Configuration export and import operations must be done on the TrueSight Network Automation systems with the same version.

Do the following:

On the Network > Import/Export > Configuration Export Tasks page, click Add Icon_Add.pngand do the following:

  1. In the Name field, enter a name for the export task. 
  2. (Optional) In the Annotation field, enter a comment or remark about the export task.
  3. In Destination, in the Server field, select whether the export is to a local or remote server.
    TrueSight Network Automation uses Secure Copy Protocol (SCP) when exporting to a remote server. Before exporting to a remote server, be sure SCP is enabled on the server (as discussed in Confirming installation of FTP or SCP).
  4. If you chose Remote Server in the Server field, specify details for connecting to the remote server and performing the remote copy — host name or IP address, SSH port (default: 22), user name, and password.
  5. In Destination, enter the following information:
    • Destination Directory: Specify the directory to which export the configuration files. This directory must be accessible to the server. The default directory is the /configs directory in the BCAN_DATA directory (for example, C:/BCA-Networks-Data/configs).

    • Exported Filename: Specify a file name for the exported configuration files. The default is ${device.host}-config, which substitutes the hostname/IP address from the device record.

      Note

      If Exported Filename contains special characters such as ",<, >, :, *, ?, /, or \ within resolved substitution parameter values, these characters are replaced by an underscore (_) during export. During configuration import, you must ensure that you replace the system-introduced underscores with the expected characters.

    • Zip Exported Files: (Optional) Select this option to compress files into a single .zip file for export. Enter the .zip filename. The default .zip file name is config${current.date}-${current.time}.zip.

      Note

      You can use the following options in the file names that you specify in the Exported Filename and Zip Filename:

      The date and time are always expressed as mm/dd/yy hh:mm:ss regardless of locale settings (mm = month, dd = date, yy = two-digit year, hh = hour in 24-hour format, mm = minutes, ss = seconds).

      For information about how ${localhostAddress}, ${localhostFullName}, and ${localhostName} are resolved see Adding-global-substitution-parameters.

      Example: ${device.name}:${config.timestamp}.cfg generated the Exported Filename: ATL-cisco1720-01: 07/21/05 15:29:31.cfg.

  6. In the Network Span field, specify which realm, group, or device to export configurations.
  7. In the Configuration field, select which configuration to export for the selected network span, one of the following options:
    • Current Running: Export the current running configuration.
    • Current Startup: Export the current startup configuration.
    • Trusted Running: Export the trusted running configuration.
    • Trusted Startup: Export the trusted startup configuration.
    • Target: Export the target configuration.
    • Historical Running: Export the running configuration on the selected date/time.
    • Historical Startup: Export the startup configuration on the selected date/time.
    • Other Current: Export a different current configuration.
    • Other Historical: Assign a historical configuration.
  8. Choose any of the following options, as relevant:
    • Enabled: Select to enable the export task. By default the task is enabled.
    • Auto Purge: Select if the export task should be purged after its scheduled execution. The default is to manually purge export tasks.
    • Overwrite Existing Files: Select if the configuration file should be overwritten if a file already exists in the directory specified. The default is to overwrite existing files.
    • Export Only Configurations Changed Since Last Export: Export the configuration only if it has changed since the last export. The default is to always export.
  9. In the Repeat field, specify the frequency to repeat the export task. Then, in the Export Time box, specify the time to export according to your selection in the Repeat field:
    • Export Once: Export Now or at a Date/Time in the future.
    • Export Daily: Specify the time (hour and minute) to execute the export task each day.
    • Export Weekly: Specify the time (hour and minute) and day(s) of the week to execute the export task.
    • Export Monthly: Specify the day of the month and export time to execute the export task.
  10. Click Save.

 

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