Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Installing the Network Agent Package (Junos Telemetry Interface)

Network Agent functions as a gRPC server and terminates the OpenConfig RPC interfaces. It is also responsible for streaming the telemetry data according to the OpenConfig specification. The Network Agent component also supports SSL/TLS. Client-based SSL/TLS authentication is not supported. You must install SSL/TLS certificates on your Juniper Networks device.To view the OpenConfig specification for telemetry, see the OpenConfig Telemetry specification. For more information about OpenConfig for Junos OS, see the OpenConfig User Guide.

Note:

  • Starting in Junos OS Release 18.3R1, OpenConfig and Network Agent packages are bundled into the Junos OS image by default. Both packages support JTI.

  • Starting in Junos OS Evolved Release 19.1R1, OpenConfig (OC) and Junos Telemetry Interface (JTI) are supported. The OpenConfig and Network Agent packages are bundled into the Junos OS Evolved image by default. Both packages support JTI.

Before you begin:

  • Install Junos OS Release 16.1R3 or later.

  • Install the OpenConfig for Junos OS module. Using a Web browser, navigate to the All Junos Platforms software download URL on the Juniper Networks webpage: https://www.juniper.net/support/downloads/. From the Network Management tab, scroll down to select OpenConfig. Select the Software tab. Select the OpenConfig Package (Junos with upgraded FreeBSD). For more information, seeInstalling the OpenConfig Package.

  • Install Transport Layer Security (TLS) certificates of authentication on your Juniper Networks device.

    Note:

    Only server-based TLS authentication is supported. Client-based authentication is not supported.

Starting with Junos OS Release 16.1R3, the Junos Network Agent software package provides a framework to support OpenConfig and gRPC for the Junos Telemetry Interface on MX Series routers and PTX5000 routers. The Network Agent package functions as a gRPC server that terminates the OpenConfig remote procedure call (RPC) interfaces and streams the telemetry data according to the OpenConfig specification. The Junos Network Agent package, which runs on the Routing Engine, implements local statistics collection and reports data to active telemetry stream subscribers.

Starting with Junos OS Release 17.2R1, the Junos Network Agent Package is also supported on QFX10000 switches and QFX5200 switches.

Starting with Junos OS Release 17.3R1, the Junos Network Agent Package is supported on QFX5110 switches and EX9200 switches.

Network Agent for Junos OS software package has the following naming conventions:

  • Package Name—This is Network-Agent.

  • Architecture—This field indicates the CPU architecture of the platforms, such as x86.

  • Application Binary Interface (ABI)—This field indicates the “word length” of the CPU architecture. The alue is 32 for 32-bit architectures.

  • Release—This field indicates the Junos OS release number, such as 16.1R3.16.

  • Package release and spin number—This field indicates the package version and spin number, such as C1.1.

All Junos Network Agent packages are in tarred and gzipped (.tgz) format.

Note:

Each version of the Network Agent package is supported on a single release of Junos OS only. The Junos OS version supported is identified by the Junos OS release number included in the Network Agent package name.

An example of a valid Network Agent package name is:

  • network-agent-x86-32-16.1R4.12-C1.1.tgz

Use the 32-bit Network Agent package for both 32-bit and 64-bit versions of Junos OS or Junos OS Evolved.

To download and install the Network Agent package:

  1. Using a Web browser, navigate to the All Junos Platforms software download URL on the Juniper Networks webpage: https://www.juniper.net/support/downloads/.
  2. Select the name of the Junos OS platform for the software that you want to download.
  3. Select the release number (the number of the software version that you want to download) from the Release drop-down list to the right of the Download Software page.
  4. Select the Software tab.
  5. In the Tools section of the Software tab, select the Junos Network Agent package for the release.
  6. Log in to the Juniper Networks authentication system using the username (generally your e-mail address) and password supplied by a Juniper Networks representative.
  7. Download the software to a local host.
  8. Copy the software to Juniper Networks device or to your internal software distribution site.
  9. Install the new network-agent package on the device by issuing the request system software add package-name from the operational mode:

    For example:

    Note:

    The command uses the validate option by default. This option validates the software package against the current configuration as a prerequisite to adding the software package to ensure that the device reboots successfully. This is the default behavior when the software package being added is a different release.

  10. Issue the show version | grep na\ telemetry command to verify that the Network Agent package was successfully installed.

Related Documentation

Change History Table

Feature support is determined by the platform and release you are using. Use Feature Explorer to determine if a feature is supported on your platform.

Release
Description
18.3R1
Starting in Junos OS Release 18.3R1, the Junos OS image includes the Network Agent.
17.3R1
Starting with Junos OS Release 17.3R1, the Junos Network Agent Package is supported on QFX5110 switches and EX9200 switches.
17.2R1
Starting with Junos OS Release 17.2R1, the Junos Network Agent Package is also supported on QFX10000 switches and QFX5200 switches.
16.1R3
Starting with Junos OS Release 16.1R3, the Junos Network Agent software package provides a framework to support OpenConfig and gRPC for the Junos Telemetry Interface on MX Series routers and PTX5000 routers.