Installing the Network Agent Package (Junos Telemetry Interface)
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.
Starting in Junos OS Release 18.3R1, the Junos OS image includes the Network Agent. You do not need to install Network Agent separately. This is true for Junos OS with upgraded FreeBSD and legacy Junos OS.
The Junos Network Agent is available as a separate package only for Junos OS with Upgraded FreeBSD. This package also includes the required YANG models. For other versions of Junos OS, Network Agent functionality is embedded in the software. For more information about Junos OS with Upgraded FreeBSD, see Release Information for Junos OS with Upgraded FreeBSD.
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.
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:
Use the 32-bit Network Agent package for both 32-bit and 64-bit versions of Junos OS or Junos OS Evolved.
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, see Installing the OpenConfig Package.
Install Secure Sockets Layer (SSL) certificates of authentication on your Juniper Networks device.
Only server-based SSL authentication is supported. Client-based authentication is not supported.
To download and install the Network Agent package:
- Using a Web browser, navigate to the All Junos Platforms software download URL on the Juniper Networks webpage: https://www.juniper.net/support/downloads/.
- Select the name of the Junos OS platform for the software that you want to download.
- 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.
- Select the Software tab.
- In the Tools section of the Software tab, select the Junos Network Agent package for the release.
- Log in to the Juniper Networks authentication system using the username (generally your e-mail address) and password supplied by a Juniper Networks representative.
- Download the software to a local host.
- Copy the software to Juniper Networks device or to your internal software distribution site.
- Install the new network-agent package on the
device by issuing the request system software add package-name from
the operational mode:
For example:user@host > request system software add network-agent-x86-32-16.1R3.16-C1.0.tgz
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.
- Issue the show version | grep na\ telemetry command to verify that the Network Agent package was successfully
user@host> show version | grep na\ telemetry
JUNOS na telemetry [20161109.201405_builder_junos_161_r3]
For information about configuring gRPC services on your Juniper Networks device, see gRPC Services for Junos Telemetry Interface.