TrueSight Network Automation 21.08

TrueSight Network Automation is a web-based application that automates the configuration and compliance of network assets.

Release notes and notices Updated 08 Sep 2021


Tip

To stay informed of changes to this space, place a watch on this page.

This section provides information about what is new or changed in this space, including urgent issues, documentation updates, service packs, and patches.

Date

Title

Summary

September 9, 2021

Enhancements and fixes available in this release

Tips

Ready-made PDFs are available on the PDFs and videos page. You can also create a custom PDF.

Click here to see the steps.

The BMC Documentation portal gives you the ability to generate PDF exports of multiple pages in a space.  

Creating PDF exports

You can create a PDF of a page or a set of pages. (Non-English page exports are not supported.) You can also create a Word document of the current page.

To export to PDF

  1. Click the Export icon in the upper-right. 1744830844926-963.png
  2. From the Export menu, select PDF.
  3. Follow the prompts for page selection and other options.
  4. Click Export.

 


Planning

Concepts, architecture, deployment, planning, and system requirements.

Installing

Information about installing the product and migrating product data.

configuring after installation

Required post-installation configuration.

Upgrading

Upgrade process, migration, and configuration.

Troubleshooting

Issues resolution, error messages, logs, and contacting Support.

Using

Interface descriptions, using the product.

Administering

Security, system administration, maintenance.

Developing

Development interfaces and toolkits.

Integrating

Integrations with other products.
What's new?


Review the TrueSight Network Automation 21.08 enhancements for features that will benefit your organization and to understand changes that might impact your users.

Performance improvements

Performance of the following components is improved during listing:

  • Combo groups
  • Device import tasks
  • Devices
  • Events
  • Groups
  • Jobs
  • OS images (sorting is also improved for this component)
  • Policies
  • Predefined jobs
  • Realms 
  • Roles
  • Rules
  • Security vulnerabilities
  • Users


Security enhancements

This release provides the following security enhancements.

Support for an enhanced algorithm to store logon passwords

When local authentication is used, Network Automation stores logon passwords in the database using the PBKDF2WithHmacSHA256 algorithm.

Due to the algorithm change, when existing Network Automation users log on to the GUI after upgrade to 21.08, they are prompted to change their password.

Change in the GET call response for the Action services

In REST API version 4.0, the runtimeProperties parameter no longer gets populated in the Action services GET call response. Therefore, if your automation or integration is dependent on this parameter, you might want to use the runtimePropertiesMasked parameter instead. Due to change in the Action services, the GET calls for the following services are affected:

  • Jobs
  • Rules
  • Predefined Jobs
  • Policies

Change in the BcanInstalledConfiguration.xml file

As a security improvement measure, the BcanInstalledConfiguration.xml file no longer stores any password.

Import Network Automation site certificates into Multi-Server Administration

Before you add any TrueSight Network Automation application server as a site into Multi-Server Administration, you need to first import the application server's certificate into Multi-Server Administration. For more information, see Importing-TrueSight-Network-Automation-site-certificates-into-Multi-Server-Administration.


Local authentication for REST API and SSH Proxy CLI when using SAML authentication for GUI

When using SAML authentication for GUI, Network Automation now supports local authentication for REST API and SSH Proxy CLI. Local authentication is enabled by default if the setting for the OAuth server is disabled. To use local authentication, you need to create users.

For more information, see Authentication.


Enhancement in the execution mechanism of an external script action

If you set the <spanSelection> tag to true for an external script action and run the action on more than one device, it runs concurrently on those devices. The number of devices on which it runs concurrently depends on the value of the maxConcurrentDeviceActions parameter in the global.properties file. In versions earlier than 21.08, the action runs serially in the order of the device names. 

For more information, see Developing-an-external-script-action-adapter.


Run the Populate End of Life Date external script action on a specific network span

In versions earlier to 21.08, the Populate End of Life Date external script action runs on all Cisco devices in your network. Starting with version 21.08, you can specify the network span on which you want to run this action. However, you cannot choose the entire network as a span. 

For any policies, jobs, or predefined jobs that were using this action before upgrade, you need to select the network span manually after you upgrade to version 21.08. For more information about this action, see Populating-End-of-Life-data-for-Cisco-devices.


Populate End of Life (EOL) data via an HTTP or HTTPS proxy server

You can populate EOL data via an HTTP or HTTPS proxy server when the application server does not have internet connectivity. To populate data, you need to run the predefined job, Populate Cisco Device Board Models and their End of Life Date on the application server via the proxy server. For more information, see Populating EOL data when application server does not have internet connectivity.


Availability of the Discrepancy and Compliance Violation Details dashboard

The Discrepancy and Compliance Violation Details dashboard, which was available upto Network Automation version 8.9, is available again now along with the dashboard that was introduced in version 20.02.

You can enable this dashboard by using the Display Discrepancy and Compliance Violation Details Dashboard system parameter. For more information about this parameter, see Managing-system-parameters.

DCVDetails_Dashboard.png


New device substitution parameters

Network Automation supports the following device substitution parameters:

  • nic: Resolves to the agent Network Interface Card (NIC) Address for a device's primary interface.
  • aux_nic: Resolves to the agent NIC Address for a device's auxiliary interface.

You can use these parameters in multiple components such as devices, agents, and external script actions. For more information, see About-substitution-parameters.


Log an event for a snapshot action status change

Use the new system parameter, Enable Event Logging for the Successful Snapshot Action After a Failure to log an event when a snapshot action succeeds after failing as part of a previous job run. The Events page shows an Info type of event when the snapshot action succeeds.

For more information about this parameter, see Device section


Search for a realm across sites

In Network Automation – Multi-Server Administration, you can now search for a realm across sites by the realm name. For more information, see Searching for a realm across sites.


Support for additional databases

Network Automation supports the following databases:

  • Microsoft SQL Server 2019
  • PostgreSQL 13.2
  • PostgreSQL 12.6

For the complete list of supported databases, see Database support.


Support for additional operating systems

Network Automation and Multi-Server Administration support the following operating systems:

  • Oracle Enterprise Linux 8.3
  • Oracle Enterprise Linux 7.9
  • Red Hat Enterprise Linux 8.3
  • Red Hat Enterprise Linux 7.9
  • Ubuntu Linux 20.04 LTS

For the complete list of supported operating systems, see OS support.


Support for Entuity Network Analytics versions

Network Automation supports the following versions of Entuity Network Analytics:

  • 19.0
  • 18.0 Patch 06

For the complete list of supported versions, see Entuity-Network-Analytics.

Frequently asked questions and other information

This topic provides information that supplements the version 21.08 version of the TrueSight Network Automation documentation. It contains the following sections:

Frequently asked questions

This section provides answers to frequently asked questions (FAQs) about Network Automation.

What happened to all the PDFs for this product?
Where do I find release note information?

The following table describes where you can find information previously provided in release notes.

Type of information

Found here in

New features (enhancements) and other information

  • Issues corrected by the base release and its service packs and patches
  • Issues that are currently open
Where can I find technical bulletins?

Technical bulletins contained information delivered after a product was released, often in conjunction with a service pack or patch for that release.

Where to find information previously provided in a technical bulletin

Type of technical bulletin

Found here in

Contents of a service pack or patch and instructions particular to it

Other information

Placed in context throughout this space, but listed and linked to in Technical bulletins. You will not have this topic in the first release of the product such as 8.9.00.

Where do I find information that was previously published as a flash bulletin?

Flashes contained urgent information about product issues and are delivered after a product is released. On docs.bmc.com, this information is delivered in an "Urgent issues" topic, under Release-notes-and-notices. If this topic does not exist for a given product release, no urgent issues have been discovered for that release.

Is all the content for TrueSight Network Automation 21.08 in this space?

Yes, all the content for 

TrueSight Network Automation

 21.08 is in this space.

Which versions of third-party products are supported by TrueSight Network Automation?

Product version

Java version

Apache Tomcat web server version

21.08

AdoptOpenJDK 11.0.5

9.0.50

I’d like a PDF of just selected information. How can I do that?

The BMC Documentation portal gives you the ability to generate PDF exports of multiple pages in a space.  

Creating PDF exports

You can create a PDF of a page or a set of pages. (Non-English page exports are not supported.) You can also create a Word document of the current page.

To export to PDF

  1. Click the Export icon in the upper-right. 1744830844926-963.png
  2. From the Export menu, select PDF.
  3. Follow the prompts for page selection and other options.
  4. Click Export.

 

Depending on the number of topics included in the export, it might take several minutes to create the PDF. Once the export is complete, you can download the PDF.

 

Additional resources from BMC

The following BMC sites provide information outside of the TrueSight Network Automation 21.08 documentation that you might find helpful:

PDFs and videos

This topic describes and links to PDFs and videos that support this product release. If the ready-made PDFs of this space do not satisfy your requirements, you can export a custom PDF.

Tip

You can create a custom PDF for a specific topic, a topic and its children, or a group of topics with a specific label. For information about how you can export a custom PDF from this space, see Exporting-to-PDF-and-other-formats.

Ready-made PDFs of this space

You must log in or register to view this page

Videos

The following table lists topics that contain videos that supplement or replace the text-based documentation. 

Category

Topics with videos

Getting started

Upgrading

Administering

 

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