Junos Overview
Junos Overview
Junos Overview
Published
2023-03-14
ii
Juniper Networks, the Juniper Networks logo, Juniper, and Junos are registered trademarks of Juniper Networks, Inc.
in the United States and other countries. All other trademarks, service marks, registered marks, or registered service
marks are the property of their respective owners.
Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right
to change, modify, transfer, or otherwise revise this publication without notice.
The information in this document is current as of the date on the title page.
Juniper Networks hardware and software products are Year 2000 compliant. Junos OS has no known time-related
limitations through the year 2038. However, the NTP application is known to have some difficulty in the year 2036.
The Juniper Networks product that is the subject of this technical documentation consists of (or is intended for use
with) Juniper Networks software. Use of such software is subject to the terms and conditions of the End User License
Agreement ("EULA") posted at https://support.juniper.net/support/eula/. By downloading, installing or using such
software, you agree to the terms and conditions of that EULA.
iii
Table of Contents
About This Guide | ix
1 Understanding Junos OS
Junos OS Software Overview | 2
Junos OS Overview | 3
Requirements | 31
Overview | 31
Configuration | 31
Verification | 34
Configuring Junos OS for the First Time on a Device with a Single Routing Engine | 54
Configuring Junos OS for the First Time on a Device with Dual Routing Engines | 59
Format for Specifying IP Addresses, Network Masks, and Prefixes in Junos OS Configuration
Statements | 66
Using Junos OS to Specify the Number of Configurations Stored on the CompactFlash Card | 70
backup-router | 89
commit (System) | 90
compress-configuration-files (System) | 93
configuration-database | 95
domain-name | 98
domain-search | 99
fib-local | 101
fib-remote | 102
filter | 103
host-name | 104
inet6-backup-router | 105
memory-enhanced | 109
management-instance | 110
max-configurations-on-flash | 112
mirror-flash-on-disk | 113
non-subscriber-no-reply | 117
no-route-localize | 118
vi
pic-console-authentication | 119
ports | 122
processes | 124
redundancy-interface-process | 127
root-authentication | 129
route-localization | 132
saved-core-context | 135
saved-core-files | 137
static-host-mapping | 138
vpn-label | 140
Use this guide to get familiar with the various functions of Junos OS devices, and learn how to
configure, monitor, and manage them.
1 PART
Understanding Junos OS
CHAPTER 1
IN THIS CHAPTER
Junos OS Overview | 3
The Overview for Junos OS is intended to provide a technical and detailed exploration of Junos OS,
explaining both concepts and operational principles, as well as how to configure and use Juniper
Networks devices.
• Understanding Junos OS
• Security management
• Device configuration
• Device monitoring
3
For a basic introduction to Junos OS, see the Getting Started Guide for Junos OS. It provides a high-level
description of Junos OS, describes how to access devices, and provides simple step-by-step instructions
for initial device configuration.
For introductory and overview information specific to Junos OS Evolved, see Introducing Junos OS
Evolved. This guide will acquaint you with Junos OS Evolved, the next generation Junos OS, and explain
its strengths, similarities to, and differences from Junos OS.
To learn how to use the Junos OS command-line interface (CLI) and understand more advanced Junos
OS topics, see the CLI User Guide. This guide explains how to use the CLI, enter configuration
statements, manage configurations, and enter operational commands for monitoring Junos OS
networking devices.
RELATED DOCUMENTATION
Junos OS Overview
Juniper Networks provides high-performance network devices that create a responsive and trusted
environment for accelerating the deployment of services and applications over a single network. The
Junos operating system (Junos OS) is the foundation of these high-performance networks. Unlike other
complex, monolithic software architectures, Junos OS incorporates key design and developmental
differences to deliver increased network availability, operational efficiency, and flexibility. These key
advantages are:
Unlike other network operating systems that share a common name but splinter into many different
programs, Junos OS is a cohesive operating system that is supported across all devices and product
4
lines. This enables Juniper Networks engineers to develop software features once and share the features
across product lines simultaneously. Because features are common to a single source, generally these
features are implemented the same way for all of the product lines, reducing the training required to
learn different tools and methods for each product.
Each new mainline version of Junos OS is released concurrently for all product lines. Each new Junos OS
release includes working features released in previous versions of the software and must achieve zero
critical regression errors. Any deprecated features or functions are not only announced, but any needed
workarounds or solutions are provided. This discipline ensures reliable operations for the entire release.
Generally, Junos OS is preinstalled on your Juniper Networks device when you receive it from the
factory. When you first power on the device, all software starts automatically. You then configure the
software so that the device can participate in your network. However, if needed, you can order Juniper
Networks devices without any software installed, for additional flexibility.
You can upgrade the device software as new features are added or software problems are fixed. You
obtain new software by downloading images from the Juniper Networks Support website onto your
device or another system on your local network, then install the software upgrade on the device.
Juniper Networks devices run only binaries supplied by Juniper Networks. Each Junos OS image
includes a digitally signed manifest of executables, which are registered with the system only if the
signature can be validated. Junos OS will not execute any binary without a registered fingerprint. This
feature protects the system against unauthorized software and activity that might compromise the
integrity of your network devices.
RELATED DOCUMENTATION
IN THIS SECTION
The routing process is handled by the following two components (see Figure 1 on page 6):
• Routing Engine
Because this architecture separates control operations such as routing updates and system management
from packet forwarding, the router can deliver superior performance and highly reliable Internet
operation.
6
The Packet Forwarding Engine uses application-specific integrated circuits (ASICs) to perform Layer 2
and Layer 3 packet switching, route lookups, and packet forwarding. The Packet Forwarding Engine
forwards packets between input and output interfaces.
Routing Engine
The Routing Engine controls the routing updates and the system management. The Routing Engine
consists of routing protocol software processes running inside a protected memory environment on a
general-purpose computer platform. The Routing Engine handles all of the routing protocol processes
7
and other software processes that control the routers’ interfaces, some of the chassis components,
system management, and user access to the router. These routers and software processes run on top of
a kernel that interacts with the Packet Forwarding Engine.
• Routing protocol packets processing—All routing protocol packets from the network are directed to
the Routing Engine, and therefore do not unnecessarily delay the Packet Forwarding Engine.
• Software modularity—Software functions are in separate processes, so a failure of one process has
little or no effect on other software processes.
• Scalability—Junos OS routing tables are designed to hold all the routes used in current and near-
future networks. Additionally, Junos OS can efficiently support large numbers of interfaces and
virtual circuits.
• Storage and change management—Configuration files, system images, and microcode are held and
maintained in one primary and two secondary storage systems, permitting local or remote upgrades.
• Monitoring efficiency and flexibility—Alarms are generated and packets are counted without
adversely affecting packet forwarding performance.
The Routing Engine constructs and maintains one or more routing tables. From the routing tables, the
Routing Engine derives a table of active routes, called the forwarding table, which is then copied into the
Packet Forwarding Engine. The forwarding table in the Packet Forwarding Engine can be updated
without interrupting the router’s forwarding.
RELATED DOCUMENTATION
Junos OS Overview | 3
Junos OS runs on all Juniper Networks devices, including both routers and switches. This section
focuses specifically on router hardware components.
Table 1 on page 8 lists the major hardware components in each router series.
8
NOTE: The ACX Series router is a single-board router with a built-in Routing Engine and one
Packet Forwarding Engine. The “pseudo” FPCs and PICs are described in ACX2000 and
ACX2100 Routers Hardware and CLI Terminology Mapping.
Routing Engines X X X X X
Control Board X X X
Power Supply X X X X X
Cooling System X X X X X
Flexible PIC Concentrators (FPCs) are each populated by PICs for various interface types. On some
routers, the PICs are installed directly in the chassis.
For information about specific components in your router, refer to its hardware guide.
9
RELATED DOCUMENTATION
IN THIS SECTION
Initialization Process | 10
Management Process | 10
Process Limits | 10
Interface Process | 10
Chassis Process | 11
Junos OS also runs on the Routing Engine. Junos OS consists of software processes that support
Internet routing protocols, control router interfaces and the router chassis, enable router system
management, and much more. Junos OS processes run on top of a kernel, which enables communication
between processes and provides a direct link to the Packet Forwarding Engine software. Junos OS can
be used to configure routing protocols and router interface properties, as well as to monitor and
troubleshoot protocol and network connectivity problems.
The Routing Engine software consists of several software processes that control router functionality and
a kernel that provides the communication among the processes. Following is a listing of the major
Routing Engine-related processes.
The Routing Engine kernel provides the underlying infrastructure for all Junos OS processes, including
providing the link between the routing tables and the Routing Engine’s forwarding table. The kernel is
also responsible for all communication with the Packet Forwarding Engine, which includes keeping the
Packet Forwarding Engine’s copy of the forwarding table synchronized with the master copy in the
Routing Engine.
10
Initialization Process
When the device boots, an initialization process (init) starts and monitors all the other software
processes.
If a software process terminates or fails to start when called, the init process attempts to restart it a
limited number of times and logs any failure information for further investigation.
Management Process
The management process (mgd) manages the configuration of the router and all user commands. The
management process is responsible for notifying other processes when a new configuration is
committed. A dedicated management process handles Junos XML protocol XML requests from its client,
which might be the CLI or any Junos XML protocol client.
Process Limits
There are limits to the total number of Junos OS processes that can run simultaneously on a device.
There are also limits set for the maximum number of iterations of any single process. The limit for
iterations of any single process can only be reached if the limit of overall system processes is not
exceeded.
Access methods such as telnet and SSH spawn multiple system processes for each session created. For
this reason, it might not be possible to simultaneously support the maximum number of access sessions
for multiple services.
Within Junos OS, the routing protocol process (rpd) controls the routing protocols that run on the
device. The rpd process starts all configured routing protocols and handles all routing messages. It
maintains one or more routing tables, which consolidate the routing information learned from all routing
protocols. From this routing information, the routing protocol process determines the active routes to
network destinations and installs these routes into the Routing Engine’s forwarding table. Finally, rpd
implements routing policy, which enables you to control the routing information that is transferred
between the routing protocols and the routing table. Using routing policy, you can filter and limit the
transfer of information as well as set properties associated with specific routes.
Interface Process
The Junos OS interface process enables you to configure and control the physical interface devices and
logical interfaces present in a network device. You can configure interface properties such as the
interface location, for example, in which slot the Flexible PIC Concentrator (FPC) is installed and in
11
which location on the FPC the Physical Interface Card (PIC) is installed, as well as the interface
encapsulation and interface-specific properties. You can configure the interfaces currently present in the
device, as well as interfaces that are not present but that you might add later.
The Junos OS interface process communicates through the Junos OS kernel with the interface process
in the Packet Forwarding Engine, enabling Junos OS to track the status and condition of the network
device’s interfaces.
Chassis Process
The Junos OS chassis process (chassisd) enables you to configure and control the properties of the
device, including conditions that trigger alarms. The chassisd on the Routing Engine communicates
directly with its peer processes running on the Packet Forwarding Engine.
Junos OS supports the Simple Network Management Protocol (SNMP), which helps administrators
monitor the state of a device. The software supports SNMP version 1 (SNMPv1), version 2 (SNMPv2,
also known as version 2c, or v2c), and version 3 (SNMPv3). The Junos OS implementation of SNMP
does not include any of the security features that were originally included in the IETF SNMP drafts but
were later dropped. The SNMP software is controlled by the Junos OS SNMP and Management
Information Base II (MIB II) processes, which consist of an SNMP master agent and various subagents.
RELATED DOCUMENTATION
Junos OS consists of multiple processes that run on different platforms and have unique functions. The
separation of functions provides operational stability, because each process accesses its own protected
memory space. This section provides a brief overview of Junos OS routing-specific processes.
As an example, Table 2 on page 12 describes the processes that run on MX Series 5G Universal
Routing Platforms.
12
Clksync process (RE) clksyncd Defines the operation of synchronous Ethernet and
Precision Time Protocol (PTP) on a Juniper Networks
MX Series router. The operation includes
communication with the Packet Forwarding Engine
(clock-sync module) to program and process clock
events from the EEC clock.
Clock-sync process (PFE) clock-sync Programs and monitors the modular interface card
(MIC), the CPLD, and the EEC clock. Peer of the
clksyncd process module.
Statistics agent process stats-agentd Acts as a relay process to collect interface statistics
for all software development kit (SDK) applications.
Table 3 on page 13 lists other processes that are common across Junos OS routing platforms.
13
Access Node Control ancpd-service Works with a special Internet Group Management
Protocol (ANCP) Protocol (IGMP) session to collect outgoing interface
process mapping events in a scalable manner.
RADIUS accounting audit-process Gathers statistical data that can be used for general
process network monitoring, analyzing, and tracking usage
patterns, for billing a user based upon the amount of
time or type of services accessed.
Universal Edge Layer ce-l2tp-service (M10, M10i, M7i, and MX Series routers only)
2 Tunneling Protocol Establishes L2TP tunnels and Point-to-Point
process Protocol (PPP) sessions through L2TP tunnels.
Ethernet OAM cfm Monitors the physical link between two switches.
connectivity fault
management process
Craft interface I/O craft-control Controls the I/O of the craft interface.
control process
Database replication database-replication (EX Series switches and MX Series routers only)
process Manages the replication of updates from the
primary to the client in the database management
system.
Datapath trace datapath-trace-service Traces the path taken by the packet through the
process network.
Dynamic Host dhcp-service (EX Series switches and MX Series routers only)
Configuration Enables a DHCP server to allocate network IP
Protocol process addresses and deliver configuration settings to client
hosts without user intervention.
15
Diameter process diameter-service Implements the Diameter protocol which uses the
Transmission Control Protocol (TCP) and Stream
Control Transmission Protocol (SCTP) instead of
User Datagram Protocol (UDP), for monitoring the
network.
Disk monitoring disk-monitoring Checks the health of the hard drive on the Routing
process Engine.
ECC parity errors ecc-error-logging Logs the ECC parity errors into the memory on the
logging process Routing Engine.
Ethernet OAM Link- ethernet-link-fault-management (EX Series switches and MX Series routers only)
Fault-Management Provides the OAM link fault management (LFM)
process information for Ethernet interfaces.
eventd
Inter-Chassis iccp-service Synchronizes data within a set of two (or more) PEs
Communication that form a redundancy group (RG).
Protocol (ICCP)
process
IDP policy process idp-policy Enables various attack detection and prevention
techniques on traffic traversing the network.
Kernel replication kernel-replication Replicates the state of the backup Routing Engine
process when graceful Routing Engine switchover (GRES) is
configured.
17
lrmuxd
NFS mount requests mountd-service (Some EX Series switches and MX Series routers
process only) Completes internal NFS mount requests for
MS-PIC and MS-MPC.
Multicast Snooping multicast-snooping (EX Series switches and MX Series routers only)
process Makes Layer 3 information, such as the MAC
addresses of members of a multicast group, known
to Layer 2 devices, such as VLAN switches.
Remote NFS server nfsd-service Provides remote file access for applications that
process need NFS-based transport.
pgcpd
PIC services logging pic-services-logging Enables PICs to send special logging information to
process the Routing Engine for archiving on the hard drive.
or
Universal edge PPP ppp-service Enables transporting IP traffic across universal edge
process routers.
SDK service process sdk-service Runs on the Routing Engine and enables
communication between the SDK application and
Junos OS. Although the SDK service process is
present on the router, it is turned off by default.
Secure Neighbor secure-neighbor-discovery (EX Series switches and MX Series routers only)
Discovery (SND) Provides support for protecting NDP messages.
or
protocol process
send
Service Deployment service-deployment Enables Junos OS to work with the Session and
System (SDX) process Resource Control (SRC) software.
Virtual Router vrrp (EX Series switches and MX Series routers only)
Redundancy Protocol Enables hosts on a LAN to make use of redundant
(VRRP) process routing platforms on that LAN without requiring
more than the static configuration of a single default
route on the hosts.
IN THIS SECTION
Generally, Junos OS files are stored in the following directories on the device:
• /altconfig—When you back up the currently running and active file system partitions on the device to
standby partitions using the request system snapshot command, the /config directory is backed up to /
23
altconfig. Normally, the /config directory is on the CompactFlash card and /altconfig is on the hard
disk.
• /altroot—When you back up the currently running and active file system partitions on the router to
standby partitions using the request system snapshot command, the root file system (/) is backed up to /
altroot. Normally, the root directory is on the CompactFlash card and /altroot is on the hard drive.
• /config—This directory is located on the primary boot device, that is, on the permanent storage from
which the device booted (generally the CompactFlash card (device wd0) or internal flash storage).
This directory contains the current operational router or switch configuration and the last three
committed configurations, in the files juniper.conf, juniper.conf.1, juniper.conf.2, and juniper.conf.3,
respectively.
• /var—This directory is located either on the hard drive (device wd2) or internal flash storage. It
contains the following subdirectories:
• /home—Contains users’ home directories, which are created when you create user access
accounts. For users using SSH authentication, their .ssh file, which contains their SSH key, is
placed in their home directory. When a user saves or loads a configuration file, that file is loaded
from the user’s home directory unless the user specifies a full pathname.
• /tmp—Contains core files. The software saves up to five core files, numbered from 0 through 4.
File number 0 is the oldest core file and file number 4 is the newest core file. To preserve the
oldest core files, the software overwrites the newest core file, number 4, with any subsequent
core file.
Each device ships with removable media (device wfd0) that contains a backup copy of Junos OS.
In addition to saving the configuration of logical systems in the current juniper.conf file, each logical
system has an individual directory structure created in the /var/logical-systems/logical-system-name
directory.
• /log—Contains system log and tracing files specific to the logical system.
24
To maintain backward compatibility for the log files with previous versions of Junos OS, a symbolic
link (symlink) from the /var/logs/logical-system-name directory to the /var/logical-systems/logical-
system-name directory is created when a logical system is configured.
This file system for each logical system enables logical system users to view trace logs and modify logical
system files. Logical system administrators have full access to view and modify all files specific to the
logical system.
Logical system users and administrators can save and load configuration files at the logical-system
hierarchy level using the save and load configuration mode commands. In addition, they can also issue the
show log, monitor, and file operational mode commands at the logical-system hierarchy level.
RELATED DOCUMENTATION
Junos OS implements full IP routing functionality, providing support for IP version 4 and IP version 6
(IPv4 and IPv6, respectively). The routing protocols are fully interoperable with existing IP routing
protocols, and they have been developed to provide the scale and control necessary for the Internet
core.
• BGP—Border Gateway Protocol version 4 is an EGP that guarantees loop-free exchange of routing
information between routing domains (also called autonomous systems). BGP, in conjunction with
Junos OS routing policies, provides a system of administrative checks and balances that can be used
to implement peering and transit agreements.
• ICMP—Internet Control Message Protocol router discovery enables hosts to discover the addresses
of operational routers on the subnet.
• IS-IS—Intermediate System to Intermediate System is a link-state IGP for IP networks that uses the
SPF algorithm, which also is referred to as the Dijkstra algorithm, to determine routes. The Junos OS
supports a new and complete implementation of the protocol, addressing issues of scale,
convergence, and resilience.
25
• OSPF—Open Shortest Path First is an IGP that was developed for IP networks by the Internet
Engineering Task Force (IETF). OSPF is a link-state protocol that makes routing decisions based on
the SPF algorithm.
OSPF Version 2 supports IPv4. OSPF Version 3 supports IPv6. The fundamental mechanisms of
OSPF such as flooding, designated router (DR) election, area-based topologies, and the SPF
calculations remain unchanged in OSPF Version 3. Some differences exist either because of changes
in protocol semantics between IPv4 and IPv6, or because of the need to handle the increased
address size of IPv6.
• RIP—Routing Information Protocol version 2 is a distance-vector IGP for IP networks based on the
Bellman-Ford algorithm. RIP dynamically routes packets between a subscriber and a service provider
without the subscriber having to configure BGP or to participate in the service provider’s IGP
discovery process.
Junos OS also provides the following routing and Multiprotocol Label Switching (MPLS) applications
protocols:
• BGP
• ICMP
• IS-IS
• OSPF Version 2
• RIP Version 2
• IGMP—Internet Group Management Protocol versions 1 and 2 are used to manage membership in
multicast groups.
• LDP—The Label Distribution Protocol provides a mechanism for distributing labels in non-traffic-
engineered applications. LDP enables routers to establish label-switched paths (LSPs) through a
network by mapping network layer routing information directly to data-link layer switched paths.
LSPs created by LDP can also traverse LSPs created by the Resource Reservation Protocol (RSVP).
• MPLS—Multiprotocol Label Switching, formerly known as tag switching, enables you to manually
or dynamically configure LSPs through a network. It lets you direct traffic through particular paths
rather than rely on the IGP least-cost algorithm to choose a path.
RELATED DOCUMENTATION
Junos OS Overview
A major function of the Junos OS routing protocol process is to maintain the Routing Engine’s routing
tables and use these tables to determine the active routes to network destinations. The routing protocol
process then installs these routes into the Routing Engine’s forwarding table. The Junos OS kernel then
copies this forwarding table to the Packet Forwarding Engine.
The routing protocol process maintains multiple routing tables. By default, it maintains the following
three routing tables. You can configure additional routing tables to suit your requirements.
• Unicast routing table—Stores routing information for all unicast routing protocols running on the
router. BGP, IS-IS, OSPF, and RIP all store their routing information in this routing table. You can
configure additional routes, such as static routes, to be included in this routing table. BGP, IS-IS,
OSPF, and RIP use the routes in this routing table when advertising routing information to their
neighbors.
27
• Multicast routing table (cache)—Stores routing information for all the running multicast protocols.
DVMRP and PIM both store their routing information in this routing table, and you can configure
additional routes to be included in this routing table.
With each routing table, the routing protocol process uses the collected routing information to
determine active routes to network destinations.
For unicast routes, the routing protocol process determines active routes by choosing the most
preferred route, which is the route with the lowest preference value. By default, the route’s preference
value is simply a function of how the routing protocol process learned about the route. You can modify
the default preference value using routing policy and with software configuration parameters.
For multicast traffic, the routing protocol process determines active routes based on traffic flow and
other parameters specified by the multicast routing protocol algorithms. The routing protocol process
then installs one or more active routes to each network destination into the Routing Engine’s forwarding
table.
RELATED DOCUMENTATION
By default, all routing protocols place their routes into the routing table. When advertising routes, the
routing protocols by default advertise only a limited set of routes from the routing table. Specifically,
each routing protocol exports only the active routes that were learned by that protocol. In addition, the
interior gateway protocols (IS-IS, OSPF, and RIP) export the direct (interface) routes for the interfaces on
which they are explicitly configured.
You can control the routes that a protocol places into each table and the routes from that table that the
protocol advertises. You do this by defining one or more routing policies and then applying them to the
specific routing protocol.
Routing policies applied when the routing protocol places routes into the routing table are referred to as
import policies because the routes are being imported into the routing table. Policies applied when the
routing protocol is advertising routes that are in the routing table are referred to as export policies
because the routes are being exported from the routing table. In other words, the terms import and
export are used with respect to the routing table.
28
A routing policy enables you to control (filter) which routes a routing protocol imports into the routing
table and which routes a routing protocol exports from the routing table. A routing policy also enables
you to set the information associated with a route as it is being imported into or exported from the
routing table. Filtering imported routes enables you to control the routes used to determine active
routes. Filtering routes being exported from the routing table enables you to control the routes that a
protocol advertises to its neighbors.
A defined routing policy specifies the conditions to use to match a route and the action to perform on
the route when a match occurs. For example, when a routing table imports routing information from a
routing protocol, a routing policy might modify the route’s preference, mark the route with a color to
identify it and allow it to be manipulated later, or prevent the route from even being installed in a
routing table. When a routing table exports routes into a routing protocol, a policy might assign metric
values, modify the BGP community information, tag the route with additional information, or prevent
the route from being exported altogether. You also can define policies for redistributing the routes
learned from one protocol into another protocol.
RELATED DOCUMENTATION
• Layer 2 VPNs link a set of sites that share routing information, and whose connectivity is controlled
by a collection of policies. A Layer 2 VPN is not aware of routes within your network. It simply
provides private links between sites over the service provider’s existing public Internet backbone.
• Layer 3 VPNs are the same as a Layer 2 VPN, but it is aware of routes within your network, requiring
more configuration on the part of the service provider than a Layer 2 VPN. The sites that make up a
Layer 3 VPN are connected over a service provider’s existing public Internet backbone.
• An Ethernet VPN (EVPN) enables you to connect dispersed customer sites using a Layer 2 virtual
bridge. As with other types of VPNs, an EVPN consists of customer edge (CE) devices (host, router,
or switch) connected to provider edge (PE) routers. The PE routers can include an MPLS edge switch
(MES) that acts at the edge of the MPLS infrastructure. Either an MX Series 5G Universal Routing
Platform or a standalone switch can be configured to act as an MES. You can deploy multiple EVPNs
within a service provider network, each providing network connectivity to a customer while ensuring
that the traffic sharing on that network remains private.
29
• Interprovider VPNs supply connectivity between two VPNs in separate autonomous systems (ASs).
This functionality can be used by a VPN user with connections to several Internet service providers
(ISPs), or different connections to the same ISP in various geographic regions.
• Carrier-of-carrier VPNs allow a VPN service provider to supply VPN service to a someone who is also
a service provider. The latter service provider supplies Internet or VPN service to an end user.
RELATED DOCUMENTATION
Junos OS Overview | 3
IN THIS SECTION
FIB-local Packet Forwarding Engines install all routes from the default inet and inet6 route tables into
the Packet Forwarding Engine forwarding hardware. FIB-remote Packet Forwarding Engines do not
install all the routes for the inet and inet6 routing tables. However, they do maintain local and multicast
routes.
FIB-remote Packet Forwarding Engines create a default (0/0) route in the Packet Forwarding Engine
forwarding hardware for the inet and inet6 table. The default route references a next-hop or a unilist of
next-hops that identify the FIB-local Packet Forwarding Engines that can perform full IP table lookups
for received packets.
FIB-remote Packet Forwarding Engines forward received packets to the set of FIB-local Packet
Forwarding Engines. The FIB-local Packet Forwarding Engines then perform full IP longest-match lookup
30
on the destination address and forward the packet appropriately. The packet might be forwarded out of
an egress interface on the same FIB-local Packet Forwarding Engine that performed the lookup or an
egress interface on a different FIB-local or FIB-remote Packet Forwarding Engine. The packet might also
be forwarded out of an FPC where FIB localization is not configured. The packet might also be received
locally at the Routing Engine.
When FIB localization is configured on a router with some Flexible PIC Concentrators (FPCs) being FIB-
remote and some others being FIB-local, packets arriving on the interface of the FIB-remote FPC are
forwarded to one of the FIB-local FPCs for route lookup and forwarding.
The advantage of configuring FIB localization is that it enables upgrading the hardware forwarding table
capacity of FIB-local Packet Forwarding Engines while not requiring upgrades to the FIB-remote Packet
Forwarding Engines. In a typical network deployment, FIB-local Packet Forwarding Engines are core-
facing, while FIB-remote Packet Forwarding Engines are edge-facing. The FIB-remote Packet Forwarding
Engines also load-balance traffic over the available set of FIB-local Packet Forwarding Engines.
FIB localization is currently supported on specific Junos OS devices, including the T320, T640, T1600,
and MX Series routers. To see if your hardware supports FIB localization, see the Juniper Networks
Feature Explorer.
NOTE: On MX Series routers, you can configure multiservices Dense Port Concentrators (DPCs)
as FIB-remote. However, only Modular Port Concentrators (MPCs) can be configured as FIB-
local. FIB-localization is supported only for redundant link services intelligent queuing interfaces
that carry Multilink Point-to-Point Protocol (MLPPP) traffic.
IN THIS SECTION
Requirements | 31
Overview | 31
Configuration | 31
Verification | 34
This example shows how to configure Packet Forwarding Engine FIB localization.
31
Requirements
3. Configure OSPF and OSPFv3 and make sure that OSPF adjacencies and OSPF routes to loopback
addresses are established.
• Junos OS Release 11.4 or later running on the router for T-Series routers. Junos OS Release 12.3 or
later running on the router for MX Series routers.
Overview
In this example, you configure the chassis for IPv4 and IPv6 routes and FIB localization on Router R0
and then configure the edge-facing Packet Forwarding Engines on FPC0 as fib-remote and the core-facing
Packet Forwarding Engines on FPC1 and FPC2 as fib-local. You then configure a routing policy named
fib-policy with the no-route-localize option to ensure that all routes from a specified route filter are
installed on the FIB-remote FPC.
Configuration
IN THIS SECTION
Procedure | 31
Procedure
To quickly configure this example, copy the following commands, paste them into a text file, remove any
line breaks, change any details necessary to match your network configuration, and then copy and paste
the commands into the CLI at the [edit] hierarchy level.
32
NOTE: Configuring FIB local results in a reboot of the related line card to activate the changes.
R0
Step-by-Step Procedure
The following example requires you to navigate various levels in the configuration hierarchy. For
information about navigating the Junos OS CLI, see the Junos OS CLI User Guide.
1. Configure route localization or FIB localization for IPv4 and IPv6 traffic.
[edit chassis]
user@R0# set route-localization inet
user@R0# set route-localization inet6
[edit chassis]
user@R0# set fpc 0 route-localization fib-remote
user@R0# set fpc 1 route-localization fib-local
user@R0# set fpc 2 route-localization fib-local
33
3. Configure the routing policy by including the no-route-localize statement to enable the forwarding
table policy to mark route prefixes such that the routes are installed into forwarding hardware on the
FIB-remote Packet Forwarding Engines.
[edit policy-options]
user@R0# set policy-statement fib-policy term a from route-filter 10.4.4.4/32 exact
user@R0# set policy-statement fib-policy term a then no-route-localize
user@R0# set policy-statement fib-policy term b from route-filter fec0:4444::4/128 exact
user@R0# set policy-statement fib-policy term b then no-route-localize
user@R0# set policy-statement fib-policy then accept
4. Enable the routing policy in the forwarding table by configuring the forwarding table with the fib-
policy statement.
[edit routing-options]
user@R0# set forwarding-table export fib-policy
NOTE: At least, one Packet Forwarding Engine must be configured as fib-local for the commit
operation to be successful. If you do not configure fib-local for the Packet Forwarding Engine,
the CLI displays an appropriate error message and the commit fails.
Results
From configuration mode, confirm your configuration by entering the show chassis and show policy-options
commands. If the output does not display the intended configuration, repeat the instructions in this
example to correct the configuration.
inet;
inet6;
}
Verification
IN THIS SECTION
Purpose
Action
Issue the show policy fib-policy command to check that the configured policy fib-policy exists.
Purpose
Verify FIB-localization configuration details by using the show route localization and show route localization
detail commands.
Action
Purpose
Verify that routes with the no-route-localize policy option are installed on the fib-remote FPC.
Action
*Static Preference: 5
Next hop type: Router, Next hop index: 629
Next-hop reference count: 3
Next hop: 10.130.0.2 via ge-1/0/4.0, selected
State: <Active Int="">
Age: 10:33
Task: RT
Announcement bits (1): 0-KRT
AS path: I</Active
>
RELATED DOCUMENTATION
fib-local | 101
fib-remote | 102
no-route-localize | 118
route-localization | 132
38
CHAPTER 2
IN THIS CHAPTER
IN THIS SECTION
Device security consists of three major elements: Physical security of the hardware, operating system
security, and security that can be affected through configuration.
Physical security involves restricting access to the device. Exploits that can easily be prevented from
remote locations are extremely difficult or impossible to prevent if an attacker can gain access to the
device’s management port or console. The inherent security of Junos OS also plays an important role in
router security. Junos OS is extremely stable and robust, and provides features to protect against
attacks, allowing you to configure the device to minimize vulnerabilities.
When you first install Junos OS, all remote access to the device is disabled, thereby ensuring that
remote access is possible only if deliberately enabled by an authorized user. You can establish remote
communication with a device in one of the following ways:
• Inband management: Enables connection to the devices using the same interfaces through which
customer traffic flows. Although this approach is simple and requires no dedicated management
resources, it has two disadvantages:
• Management flows and transit traffic flows are mixed together. Any attack traffic that is mixed
with the normal traffic can affect the communication with the device.
• The links between device components might not be totally trustworthy, leading to the possibility
of wiretapping and replay attacks.
For management access to the device, the standard ways to communicate with the device from a remote
console are with Telnet and SSH. SSH provides secure encrypted communications and is therefore
useful for inband device management. Telnet provides unencrypted, and therefore less secure, access to
the device.
On a device, you can create local user login accounts to control who can log in to the device and the
access privileges they have. A password, either an SSH key or a Message Digest 5 (MD5) password, is
associated with each login account. To define access privileges, you create login classes into which you
group users with similar jobs or job functions. You use these classes to explicitly define what commands
their users are and are not allowed to issue while logged in to the device.
The management of multiple devices by many different personnel can create a user account
management problem. One solution is to use a central authentication service to simplify account
management, creating and deleting user accounts only on a single, central server. A central
authentication system also simplifies the use of one-time password systems such as SecureID, which
40
offer protection against password sniffing and password replay attacks (attacks in which someone uses a
captured password to pose as a device administrator).
Junos OS supports two protocols for central authentication of users on multiple devices:
• Remote Authentication Dial-In User Service (RADIUS), a multivendor IETF standard whose features
are more widely accepted than those of TACACS+ or other proprietary systems. All one-time-
password system vendors support RADIUS.
• Internet Protocol Security (IPsec). IPsec architecture provides a security suite for the IPv4 and IPv6
network layers. The suite provides such functionality as authentication of origin, data integrity,
confidentiality, replay protection, and nonrepudiation of source. In addition to IPsec, Junos OS
supports the Internet Key Exchange (IKE), which defines mechanisms for key generation and
exchange, and manages security associations (SAs).
• MD5 authentication of MSDP peering sessions. This authentication provides protection against
spoofed packets being introduced into a peering session.
• SNMPv3 authentication and encryption. SNMPv3 uses the user-based security model (USM) for
message security and the view-based access control model (VACM) for access control. USM specifies
authentication and encryption. VACM specifies access-control rules.
Junos OS has special requirements when you create plain-text passwords on a device. The default
requirements for plain-text passwords are as follows:
• You can include uppercase letters, lowercase letters, numbers, punctuation marks, and any of the
following special characters:
!@#$%^&*,+=<>:;
Control characters are not recommended.
• The password must contain at least one change of case or character class.
You can include the plain-text-password statement at the following hierarchy levels:
The main task of a device is to forward user traffic toward its intended destination based on the
information in the device’s routing and forwarding tables. You can configure routing policies that define
the flows of routing information through the network, controlling which routes the routing protocols
place in the routing tables and which routes they advertise from the tables. You can also use routing
policies to change specific route characteristics, change the BGP route flap-damping values, perform
per-packet load balancing, and enable class of service (CoS).
Attackers can send forged protocol packets to a device with the intent of changing or corrupting the
contents of its routing table or other databases, which can degrade the functionality of the device. To
prevent such attacks, you must ensure that devices form routing protocol peering or neighboring
relationships with trusted peers. One way to do this is by authenticating routing protocol messages. The
Junos OS BGP, IS-IS, OSPF, RIP, and RSVP protocols all support HMAC-MD5 authentication, which uses
a secret key combined with the data being protected to compute a hash. When the protocols send
messages, the computed hash is transmitted with the data. The receiver uses the matching key to
validate the message hash.
Junos OS supports the IPsec security suite for the IPv4 and IPv6 network layers. The suite provides such
functionality as authentication of origin, data integrity, confidentiality, replay protection, and
nonrepudiation of source. Junos OS also supports IKE, which defines mechanisms for key generation
and exchange, and manages SAs.
Firewall filters allow you to control packets transiting the device to a network destination and packets
destined for and sent by the device. You can configure firewall filters to control which data packets are
accepted on and transmitted from the physical interfaces, and which local packets are transmitted from
the physical interfaces and the Routing Engine. Firewall filters provide a means of protecting your device
from excessive traffic. Firewall filters that control local packets can also protect your device from
external aggressions, such as DoS attacks.
To protect the Routing Engine, you can configure a firewall filter only on the device’s loopback interface.
Adding or modifying filters for each interface on the device is not necessary. You can design firewall
filters to protect against ICMP and Transmission Control Protocol (TCP) connection request (SYN) floods
and to rate-limit traffic being sent to the Routing Engine.
42
A denial-of-service attack is any attempt to deny valid users access to network or server resources by
using up all the resources of the network element or server. Distributed denial-of-service attacks involve
an attack from multiple sources, enabling a much greater amount of traffic to attack the network. The
attacks typically use network protocol control packets to trigger a large number of exceptions to the
device’s control plane. This results in an excessive processing load that disrupts normal network
operations.
Junos OS DDoS protection enables the device to continue functioning while under an attack. It
identifies and suppresses malicious control packets while enabling legitimate control traffic to be
processed. A single point of DDoS protection management enables network administrators to customize
profiles for their network control traffic. Protection and monitoring persists across graceful Routing
Engine switchover (GRES) and unified in-service-software-upgrade (ISSU) switchovers. Protection is not
diminished as the number of subscribers increases.
To protect against DDoS attacks, you can configure policers for host-bound exception traffic. The
policers specify rate limits for individual types of protocol control packets or for all control packet types
for a protocol. You can monitor policer actions for packet types and protocol groups at the level of the
device, Routing Engine, and line cards. You can also control logging of policer events.
Flow detection is an enhancement to DDoS protection that supplements the DDoS policer hierarchies
by using a limited amount of hardware resources to monitor the arrival rate of host-bound flows of
control traffic. Flow detection is much more scalable than a solution based on filter policers. Filter
policers track all flows, which consumes a considerable amount of resources. In contrast, flow detection
only tracks flows it identifies as suspicious, using far fewer resources to do so.
The flow detection application has two interrelated components, detection and tracking. Detection is
the process where flows suspected of being improper are identified and subsequently controlled.
Tracking is the process where flows are tracked to determine whether they are truly hostile and when
these flows recover to within acceptable limits.
Junos OS logs significant events that occur on the device and within the network. Although logging itself
does not increase security, you can use the system logs to monitor the effectiveness of your security
policies and device configurations. You can also use the logs when reacting to a continued and
deliberate attack as a means of identifying the source address, device, or port of the attacker’s traffic.
You can configure the logging of different levels of events, from only critical events to all events,
including informational events. You can then inspect the contents of the system log files either in real
time or later.
Debugging and troubleshooting are much easier when the timestamps in the system log files of all
devices are synchronized, because events that span the network might be correlated with synchronous
43
entries in multiple logs. Junos OS supports the Network Time Protocol (NTP), which you can enable on
the device to synchronize the system clocks of devices and other networking equipment. By default,
NTP operates in an unauthenticated mode. You can configure various types of authentication, including
an HMAC-MD5 scheme.
RELATED DOCUMENTATION
Overview of IPsec
Junos OS System Log Overview
Junos OS protects against common network device security weaknesses with the following default
settings:
• Junos OS does not forward directed broadcast messages. Directed broadcast services send ping
requests from a spoofed source address to a broadcast address and can be used to attack other
Internet users. For example, if broadcast ping messages were allowed on the 200.0.0.0/24 network, a
single ping request could result in up to 254 responses to the supposed source of the ping. The
source would actually become the victim of a denial-of-service (DoS) attack.
• Generally, by default, only console access to the device is enabled. Remote management access to
the device and all management access protocols, including Telnet, FTP, and SSH (Secure Shell), are
disabled by default, unless the device setup specifically includes a factory-installed DHCP
configuration.
• Junos OS does not support the SNMP set capability for editing configuration data. Although the
software supports the SNMP set capability for monitoring and troubleshooting the network, this
support exposes no known security issues. (You can configure the software to disable this SNMP set
capability.)
• Junos OS ignores martian (intentionally non-routable) IP addresses that contain the following
prefixes: 0.0.0.0/8, 127.0.0.0/8, 128.0.0.0/16, 191.255.0.0/16, 192.0.0.0/24, 223.255.55.0/24, and
240.0.0.0/4. Martian addresses are reserved host or network addresses about which all routing
information should be ignored.
44
CHAPTER 3
IN THIS CHAPTER
Usually, your Juniper Networks device comes with Junos OS installed on it, unless you specifically order
it without the operating system. When Junos OS is pre-installed, you simply power on the device and all
software starts automatically. You just need to configure the device so it will be ready to participate in
the network.
To configure the Junos OS, you must specify a hierarchy of configuration statements which define the
preferred software properties. You can configure all properties of the Junos OS, including interfaces,
general routing information, routing protocols, and user access, as well as some system hardware
properties. After you have created a candidate configuration, you commit the configuration to be
evaluated and activated by Junos OS.
RELATED DOCUMENTATION
IN THIS SECTION
ASCII File | 46
J-Web Package | 46
Depending on specific device support, you can use the methods shown in Table 4 on page 45 to
configure Junos OS. For more information, see the Juniper Networks Feature Explorer.
Method Description
Command-line interface Create the configuration for the device using the CLI. You can enter commands from a
(CLI) single command line, and scroll through recently executed commands.
ASCII file Load an ASCII file containing a configuration that you created earlier, either on this
system or on another system. You can then activate and run the configuration file, or
you can edit it using the CLI and then activate it.
J-Web graphical user Use the J-Web GUI to configure the device. J-Web enables you to monitor, configure,
interface (GUI) troubleshoot, and manage the router on a client by means of a Web browser. The J-
Web GUI is supported on only certain Juniper Networks devices. For more
information, see the Juniper Networks Feature Explorer.
Junos XML Client applications use the Junos XML management protocol to monitor and configure
management protocol Juniper Networks devices. The Junos XML management protocol is customized for
(API) Junos OS, and operations in the API are equivalent to those in the CLI.
46
Method Description
NETCONF application Client applications use the NETCONF XML management protocol to monitor and
programming interface configure supported devices. The NETCONF XML management protocol includes
(API) features that accommodate the configuration data models of multiple vendors.
Configuration commit Create scripts that run at commit time to enforce custom configuration rules. Commit
scripts scripts are written in Python, Stylesheet Language Alternative syntaX (SLAX), or
Extensible Stylesheet Language Transformations (XSLT).
The following sections describe the methods you can use to configure Junos OS:
The Junos OS CLI is a straightforward terminal-based command interface. You use Emacs-style keyboard
sequences to move around on a command line and scroll through a buffer that contains recently
executed commands. You type commands on a single line, and the commands are executed when you
press the Enter key. The CLI also provides command help and command completion.
ASCII File
You can load an ASCII file containing a configuration that you created earlier, either on this system or
another system. You can then activate and run the configuration file as is, or you can edit it using the CLI
and then activate it.
J-Web Package
As an alternative to entering CLI commands, Junos OS supports the J-Web GUI. The J-Web user
interface enables you to monitor, configure, troubleshoot, and manage the router on a client by means
of a Web browser with Hypertext Transfer Protocol (HTTP) or HTTP over Secure Sockets Layer (HTTPS)
enabled.
The J-Web user interface is an optional, licensed software package (jweb package) on M Series and
TSeries routers. The jweb package is not included in jinstall and jbundle software bundles. It must be
installed separately. To install the package on M Series and T Series routers, follow the procedure
described in the Software Installation and Upgrade Guide.
J-Web supports weak (56-bit) encryption by default. This enables non-US customers to install J-Web
and use HTTPS connections for J-Web access. US customers can also install the jcrypto strong
encryption package. This package automatically overrides the weak encryption.
47
NOTE: Because the J-Web package is bundled separately from other packages, it is possible to
have a version mismatch between J-Web and other Junos OS packages you have installed.
To check for a version mismatch, use the show system alarms CLI command. If the version number
does not match exactly, a system alarm appears.
The Junos XML Management Protocol is an XML-based protocol that client applications use to monitor
and configure Juniper Networks devices. It uses an XML-based data encoding for the configuration data
and remote procedure calls. This API is customized for Junos OS, and operations in the API are
equivalent to CLI commands.
The NETCONF XML management protocol is an XML-based protocol that client applications use to
monitor and configure network devices. It uses an XML-based data encoding for the configuration data
and remote procedure calls. NETCONF includes features that accommodate the configuration data
models of multiple vendors. Juniper Networks provides a set of Perl modules that enable Perl client
applications to communicate with the NETCONF server on Junos devices. The Perl modules enable you
to develop custom applications for configuring and monitoring Junos devices.
You can create and use scripts that run at commit time to enforce custom configuration rules. If a
configuration breaks the custom rules, the script can generate actions that the Junos OS performs.
These actions include:
Configuration commit scripts also enable you to create macros, which expand simplified custom aliases
for frequently used configuration statements into standard Junos OS configuration statements. Commit
scripts are written in Python, Stylesheet Language Alternative syntaX (SLAX), or Extensible Stylesheet
Language Transformations (XSLT).
48
RELATED DOCUMENTATION
CLI Explorer
CLI User Guide
Junos OS Automation Scripting User Guide
Junos OS Configuration from External Devices | 48
NETCONF XML Management Protocol Developer Guide
Software Installation and Upgrade Guide
You can configure Junos OS network device from a system console connected to the console port or by
using Telnet to access the device remotely. External management hardware can be connected to the
Routing Engine and the Junos OS through these ports:
• Console port
• Auxiliary port
NOTE: See hardware guide for your particular Junos OS device for instructions about how to
connect external hardware to the console, auxiliary, and/or Ethernet management ports.
Capabilities and features can vary depending on device model.
RELATED DOCUMENTATION
The device configuration is saved using a commit model—a candidate configuration is modified as
desired and then committed to the system. When a configuration is committed, the device checks the
configuration for syntax errors, and if no errors are found, the configuration is saved as juniper.conf.gz
and activated. The formerly active configuration file is saved as the first rollback configuration file
49
(juniper.conf.1.gz), and any other rollback configuration files are incremented by 1. For example,
juniper.conf.1.gz is incremented to juniper.conf.2.gz, making it the second rollback configuration file.
The device can have a maximum of 49 rollback configurations (numbered 1 through 49) saved on the
system.
On the device, the current configuration file and the first three rollback files (juniper.conf.gz.1,
juniper.conf.gz.2, juniper.conf.gz.3) are located in the /config directory. (The remaining rollback files, 4
through 49, are located in /var/db/config.)
If the recovery configuration file rescue.conf.gz exists, this file is also located in the /config directory.
The factory default files are located in the /etc/config directory.
There are two mechanisms used to propagate the configurations between Routing Engines within a
device:
• Synchronization: Propagates a configuration from one Routing Engine to a second Routing Engine
within the same device chassis.
To synchronize configurations, use the commit synchronize CLI command. If one of the Routing Engines
is locked, the synchronization fails. If synchronization fails because of a locked configuration file, you
can use the commit synchronize force command. This command overrides the lock and synchronizes the
configuration files.
NOTE: When you use the commit synchronize force CLI command on a multichassis platform, the
forced synchronization of the configuration files does not affect the distribution of the
configuration file across the routing plane. If a configuration file is locked on a device remote
from the device where the command was issued, the synchronization fails on the remote
device. You need to clear the lock and reissue the synchronization command.
RELATED DOCUMENTATION
Configuring Junos OS for the First Time on a Device with a Single Routing Engine
50
IN THIS SECTION
Inheritance Model | 50
This topic provides an overview of configuration groups and the inheritance model in the Junos OS CLI.
Configuration groups enable you to create a group containing configuration statements and to direct the
inheritance of that group’s statements in the rest of the configuration. The same group can be applied to
different sections of the configuration. Different sections of one group’s configuration statements can
be inherited in different places in the configuration.
Configuration groups enable you to create smaller, more logically constructed configuration files, making
it easier to configure and maintain Juniper Networks devices. For example, you can group statements
that are repeated in many places in the configuration, such as when configuring interfaces. By grouping
statements, you can limit configuration updates to just the group.
You can also use wildcards in a configuration group. Any object that matches the wildcard expression
inherits the group configuration data.
The configuration group mechanism is separate from the grouping mechanisms used elsewhere in the
configuration, such as BGP groups. Configuration groups provide a generic mechanism that you can use
throughout the configuration but that are known only to the CLI. The individual software processes that
perform the actions directed by the configuration receive the expanded form of the configuration; they
have no knowledge of configuration groups.
Inheritance Model
Configuration groups use true inheritance, which involves a dynamic, ongoing relationship between the
source of the configuration data and the target of that data. The target automatically inherits data values
that you change in the configuration group. The target does not need to contain the inherited
information. However, the inherited values can be overridden in the target without affecting the source
from which they were inherited.
51
This inheritance model enables you to see only the instance-specific information without seeing the
inherited details. A command pipe in configuration mode enables you to display the inherited data.
For areas of your configuration to inherit configuration statements, you must first put the statements
into a configuration group. You then apply that group to the levels in the configuration hierarchy that
require the statements.
1. Configure statements into a configuration group. To configure configuration groups and inheritance,
you can include the groups statement at the [edit] hierarchy level:
[edit]
groups {
group-name {
configuration-data;
}
}
2. Apply the configuration group from step 1 to the levels in the configuration hierarchy that require the
statements.
Include the apply-groups [ group-names ] statement anywhere in the configuration where the
configuration statements contained in a configuration group are needed.
2 PART
CHAPTER 4
IN THIS CHAPTER
Configuring Junos OS for the First Time on a Device with a Single Routing Engine | 54
Configuring Junos OS for the First Time on a Device with Dual Routing Engines | 59
Format for Specifying IP Addresses, Network Masks, and Prefixes in Junos OS Configuration
Statements | 66
Using Junos OS to Specify the Number of Configurations Stored on the CompactFlash Card | 70
This topic provides an overview of initial network device configuration tasks using Junos OS.
When you turn on a device for the first time, Junos OS automatically boots and starts. You must enter
basic configuration information so the device is on the network and you can log in to it over the
network.
To configure the device initially, you must connect through the console port.
When you first connect to the console of a device that has not yet been configured, log in as the user
root. At first, the root account requires no password. You can see that you are the user root, because the
command prompt shows the username root@#.
54
You must start the Junos OS command-line interface (CLI) using the command cli. The command
prompt root@> indicates that you are the user root and that you are in Junos OS operational mode. Enter
Junos OS configuration mode by typing the command configure. The command prompt root@# indicates
that you are in the Junos OS configuration mode.
When you first configure a device, you should configure the following basic properties:
• Device hostname
• Domain name
• IP address of the device management Ethernet interface. To find the management Ethernet interface
that you should use for configuration, see Supported Routing Engines by Router.
RELATED DOCUMENTATION
Configuring Junos OS for the First Time on a Device with a Single Routing Engine | 54
Configuring Junos OS for the First Time on a Device with Dual Routing Engines | 59
Supported Routing Engines by Router
Junos OS Configuration Using the CLI
Configuring Junos OS for the First Time on a Device with a Single Routing
Engine
To configure the Junos OS for the first time on a router with a single Routing Engine and no base
configuration, follow these steps:
root@# cli
root@>
cli> configure
[edit]
root@#
6. Configure the hostname of the device. We do not recommend spaces in the router name. However,
if the name does include spaces, enclose the entire name in quotation marks (" ").
[edit]
root@# set system host-name hostname
7. Set the root password, entering either a clear-text password that the system will encrypt, a
password that is already encrypted, or an SSH public key string.
Choose one of the following:
[edit]
root@# set system root-authentication plain-text-password
New password: type password
Retype new password: retype password
[edit]
root@# set system root-authentication encrypted-password encrypted-password
[edit]
root@# set system root-authentication ssh-rsa key
56
[edit]
root@# set system domain-name domain-name
NOTE: Before you begin the next step, see Supported Routing Engines by Router to find the
management Ethernet interface that you should use to perform this configuration.
9. Configure the IP address and prefix length for the device management Ethernet interface. The
management Ethernet interface provides a separate out-of-band management network for the
device.
[edit]
root@# set interfaces fxp0 unit 0 family inet address address/prefix-length
[edit]
root@# set interfaces em0 unit 0 family inet address address/prefix-length
10. Configure the IP address of a backup or default network device. Choose a device that is directly
connected to the local router by way of the management interface. This backup is used only when
it is booting and only or when the Junos routing software (the routing protocol process, rpd) is not
running.
For devices with two Routing Engines, the backup Routing Engine, RE1, uses the backup device as a
default gateway after the device boots. This enables you to access the backup Routing Engine. (RE0
is the default primary Routing Engine.)
NOTE: The backup Routing Engine does not support more than 16 backup routing
destinations. If you configure more than 16 destinations on the backup Routing Engine, the
57
Junos OS ignores any destination addresses after the sixteenth address and displays a
commit-time warning message to this effect.
[edit]
root@# set system backup-router address
11. Configure the IP address of a DNS server. The router uses the DNS name server to translate
hostnames into IP addresses.
[edit]
root@# set system name-server address
[edit]
root@ show
system {
host-name hostname;
domain-name domain.name;
backup-router address;
root-authentication {
(encrypted-password "password" | public-key);
ssh-dsa "public-key";
ssh-ecdsa "public-key";
ssh-rsa "public-key";
}
name-server {
address;
}
interfaces {
fxp0 {
unit 0 {
family inet {
address address ;
}
}
}
}
}
58
On devices that use management Ethernet interface em0, you will see em0 in place of fxp0 in the
show command output.
13. Commit the configuration, which activates the configuration on the device:
[edit]
root@# commit
After committing the configuration, you see the newly configured hostname appear after the
username in the prompt—for example, user@hostname#.
If you want to configure additional Junos OS properties at this time, remain in the CLI configuration
mode and add the necessary configuration statements. You need to commit your configuration
changes to activate them on the device.
14. Exit from the CLI configuration mode.
[edit]
root@hostname# exit
root@hostname>
The request system snapshot command causes the root file system to be backed up to /altroot, and /
config to be backed up to /altconfig. The root and /config file systems are on the device’s
CompactFlash card, and the /altroot and /altconfig file systems are on the device’s hard drive.
NOTE: After you issue the request system snapshot command, you cannot easily return to the
previous configuration, because the running copy and the backup copies are identical.
RELATED DOCUMENTATION
Format for Specifying IP Addresses, Network Masks, and Prefixes in Junos OS Configuration
Statements | 66
Default Directories for Junos OS File Storage on the Network Device | 22
Configuring Automatic Mirroring of the CompactFlash Card on the Hard Drive | 69
Configuring Junos OS for the First Time on a Device with Dual Routing
Engines
If a device has dual Routing Engines, you can create configuration groups and use the same
configuration for both Routing Engines. This ensures that the configuration will not change during a
failover scenario because of the identical configuration shared between the Routing Engines.
Configure the hostnames and addresses of the two Routing Engines using configuration groups at the
[edit groups] hierarchy level. Use the reserved configuration group re0 for the Routing Engine in slot 0
and re1 for the Routing Engine in slot 1 to define Routing Engine-specific parameters. Configuring re0
and re1 groups enables both Routing Engines to use the same configuration file.
Use the apply-groups statement to apply the apply the configuration to the device.
The commit synchronize command commits the same configuration on both Routing Engines. The command
makes the active or applied configuration the same for both Routing Engines with the exception of the
groups, re0 being applied to only RE0 and re1 being applied only to RE1. If you do not synchronize the
configurations between two Routing Engines and one of them fails, the router may not forward traffic
correctly, because the backup Routing Engine may have a different configuration.
To initially configure a device with dual Routing Engines that have no base configuration, follow these
steps:
1. If you have not already done so, refer "Configuring Junos OS for the First Time on a Device with a
Single Routing Engine" on page 54 and follow the steps to initially configure the backup Routing
Engine.
2. Create the configuration group re0. The re0 group is a special group designator that is only used by
RE0 in a redundant routing platform.
[edit]
root@host# set groups re0
60
[edit]
root@host# edit groups re0
NOTE: The hostname specified in the device configuration is not used by the DNS server to
resolve to the correct IP address. This hostname is used to display the name of the Routing
Engine in the CLI. For example, the hostname appears at the command-line prompt when
you are logged in to the CLI:
user-name@host-name>
NOTE: Before you begin the next step, see Supported Routing Engines by Router to find the
management Ethernet interface that you should use to perform this configuration.
5. Configure the IP address and prefix length for the device management Ethernet interface. The
management Ethernet interface provides a separate out-of-band management network for the
device.
[edit groups]
root@host# set interfaces fxp0 unit 0 family inet address address/prefix-length
[edit groups]
root@host# set interfaces em0 unit 0 family inet address address/prefix-length
61
6. Set the loopback interface address for the re0 configuration group:
[edit groups]
root@host# set re0 interfaces lo0 unit 0 family inet address address/prefix-length
The next steps repeat for re1 the same steps as were done for the re0 configuration group.
8. Create the configuration group re1.
[edit]
root@host# set groups re1
[edit]
root@host# edit groups re1
NOTE: Before you begin the next step, see Supported Routing Engines by Router to find the
management Ethernet interface that you should use to perform this configuration.
11. Configure the IP address and prefix length for the device management Ethernet interface.
[edit groups]
root@host# set interfaces fxp0 unit 0 family inet address address/prefix-length
62
[edit groups]
root@host# set interfaces em0 unit 0 family inet address address/prefix-length
12. Set the loopback interface address for re1 configuration group:
[edit groups]
root@host# set re1 interfaces lo0 unit 0 family inet address address/prefix-length
13. Once both configuration groups have been set up, return to the top level of the hierarchy.
14. Use the apply-groups statement to apply the configuration to the device.
[edit]
root@host# set apply-groups [ re0 re1 ]
[edit]
root@host# set chassis redundancy routing-engine 0 master
root@host# set chassis redundancy routing-engine 1 backup
[edit]
user@host> commit synchronize
After the configuration changes are saved, complete the management console configuration.
[edit]
root@host# set system root-authentication plain-text-password
63
[edit]
root@host# set system root-authentication encrypted-password encrypted-password
[edit]
root@host# set system root-authentication ssh-rsa key
[edit ]
root@host# set system name-server address
[edit ]
root@host# set system domain-name domain-name
4. Configure the IP address of a backup or default network device. A backup device is used only while
the routing protocol process is not running. Choose a backup device that is directly connected to the
local device by way of the management interface. The device uses this backup only when it is
booting and or when the Junos routing software (the routing protocol process, rpd) is not running.
For more information, see Configuring a Backup Router.
For devices with two Routing Engines, the backup Routing Engine, RE1, uses the backup as a default
gateway after the device boots. This enables you to access the backup Routing Engine. (RE0 is the
default primary Routing Engine.)
NOTE: The backup router Routing Engine does not support more than 16 backup
destinations. If you configure more than 16 destinations on the backup Routing Engine, the
64
Junos OS ignores any destination addresses after the sixteenth address and displays a
commit-time warning message to this effect.
[edit]
root@host# set system backup-router address
[edit]
root@ show
system {
host-name hostname;
domain-name domain.name;
backup-router address;
root-authentication {
(encrypted-password "password" | public-key);
ssh-dsa "public-key";
ssh-ecdsa "public-key";
ssh-rsa "public-key";
}
name-server {
address;
}
interfaces {
fxp0 {
unit 0 {
family inet {
address address ;
}
}
}
}
}
On devices that use management Ethernet interface em0, you will see em0 in place of fxp0 in the
show command output.
65
6. After you are satisfied that the configuration is successfully running, issue the request system snapshot
command to back up the new configuration on both primary and backup Routing Engines.
{master}
user@host> request system snapshot
The root file system is backed up to /altroot, and /config is backed up to /altconfig. The root and /
config file systems are on the device’s CompactFlash card, and the /altroot and /altconfig file
systems are on the device’s hard drive.
NOTE: After you issue the request system snapshot command, you cannot return to the previous
configuration, because the running copy and backup copy are identical.
For information about creating configuration groups, see Junos OS CLI User Guide.
For information about configuring high availability features for redundant Routing Engine systems and
the re0 group, see Junos OS High Availability User Guide.
RELATED DOCUMENTATION
You use configuration groups to apply configurations across other hierarchies without re-entering
configuration data. You can specify every configuration detail in a configuration groups. You can also use
wildcards in configuration groups to configure ranges of data, without detailing each configuration line.
Another way to use configuration groups is to create an inheritance path that includes a long string of
configurations to be applied.
66
When a configuration that uses configuration groups is committed, the commit process expands and
reads all the configuration data of the group into memory to apply the configurations as intended. The
commit performance can be negatively affected if many configuration groups are being applied,
especially if the configuration groups use wildcards extensively.
If your system uses many configuration groups that use wildcards, you can configure the persist-groups-
inheritance statement at the [edit system commit] hierarchy level to improve commit time performance.
Using this option enables the system to build the inheritance path for each configuration group inside
the database rather than in the process memory. This change can improve commit time performance.
However, it can also increase the database size.
You can enter software configuration statements using the CLI to create a candidate configuration that
contains a hierarchy of statements. To have a candidate configuration take effect, you commit the
changes. At this point, the candidate file is checked for proper syntax, activated, and marked as the
current, operational software configuration file. If multiple users are editing the configuration, when you
commit the candidate configuration, all changes made by all the users take effect.
The CLI always maintains a copy of previously committed versions of the software configuration. If you
need to return to a previous configuration, you can do this from within the CLI.
RELATED DOCUMENTATION
Many statements in the Junos OS configuration include an option to specify an IP address or route
prefix. This option is represented as destination-prefix/prefix-length. Specifically, the route prefix, followed
by a slash and the destination prefix length. For example, 192.168.1.10/32.
You enter all IP addresses in classless mode. You can enter the IP address with or without a prefix length,
in standard dotted notation (for example, 1.2.3.4), or hexadecimal notation as a 32-bit number in
network-byte order (for example, 0x01020304). If you omit any octets, they are assumed to be zero.
Specify the prefix length as a decimal number from 1 through 32.
67
RELATED DOCUMENTATION
In some CLI commands and configuration statements—including file copy, file archive, load, save, set
system login user username authentication load-key-file, and request system software add—you can include a
filename. On a routing matrix, you can include chassis information (for example, lcc0, lcc0-re0, or lcc0-re1)
as part of the filename.
• filename—A file in the user’s current directory on the local CompactFlash card (not applicable on the
QFX Series). You can use wildcards to specify multiple source files or a single destination file.
Wildcards are not supported in FTP.
NOTE: Wildcards are supported only by the file (compare | copy | delete | list | rename | show)
commands. When you issue the file show command with a wildcard, it must resolve to one
filename.
• filename or path/filename—File on the local hard drive. You can also specify a file on a local Routing
Engine for a specific T640 router or a T1600 router in a routing matrix:
• a:filename or a:path/filename—A file on the local removable media. The default path is / (the root-level
directory). The removable media can be in MS-DOS or UNIX (UFS) format.
place of the password. If a password is required and you do not specify the password or prompt, an
error message is displayed:
NOTE: You cannot specify a HTTP(s) URL for a file as a destination, because HTTP(s) URLs are
not writable. However you can specify HTTP(s) URL for a file as a source.
• re0:/path/filename or re1:/path/filename—A file on a local Routing Engine. You can also specify a
file on a local Routing Engine for a specific T640 router or a T1600 router in a routing matrix:
RELATED DOCUMENTATION
While using the Domain Name System (DNS) is an easier and more scalable way to resolve IP addresses
from hostnames, you might want to manually map the hostname to a static IP address for the following
reasons:
• You might not want the computer to contact the DNS server to resolve a particular IP address—you
might use this particular IP address frequently, or it might be just for testing or development
purposes.
69
1. Include the inet statement at the [edit system static-host-mapping hostname] hierarchy level.
[edit system]
user@host# show
static-host-mapping {
hostname {
inet [ ip-addresses ];
}
}
RELATED DOCUMENTATION
You can direct the device hard drive to automatically mirror the contents of the CompactFlash card.
When you include the mirror-flash-on-disk statement, the hard drive maintains a synchronized mirror
copy of the CompactFlash card contents. Data written to the CompactFlash card is simultaneously
updated in the mirrored copy of the hard drive. If the CompactFlash card fails to read data, the hard
drive automatically retrieves its mirrored copy of the CompactFlash card.
NOTE: We recommend that you disable flash-to-disk mirroring when you upgrade or downgrade
the router.
You cannot issue the request system snapshot command while flash-to-disk mirroring is enabled.
70
To configure the mirroring of the CompactFlash card to the hard drive, include the mirror-flash-on-disk
statement at the [edit system] hierarchy level:
[edit system]
mirror-flash-on-disk;
NOTE: After you have enabled or disabled the mirror-flash-on-disk statement, you must reboot
the device for your changes to take effect. To reboot, issue the request system reboot command.
RELATED DOCUMENTATION
Configuring Junos OS for the First Time on a Device with a Single Routing Engine | 54
Using Junos OS to Specify the Number of Configurations Stored on the CompactFlash Card | 70
By default, Junos OS saves the current configuration and three previous versions of the committed
configuration on the CompactFlash card, with an additional 46 older versions stored on the hard drive.
The currently operational Junos OS configuration is stored in the file juniper.conf.gz, and the last three
committed configurations are stored in the files juniper.conf.1.gz, juniper.conf.2.gz, and
juniper.conf.3.gz. These four files are located in the CompactFlash card in the directory /config.
In addition to saving the current configuration and the current operational version, you can also specify
how many previous versions of the committed configurations you want stored on the CompactFlash
card in the directory /config. The remaining previous versions of committed configurations (4 through
49) are stored in the directory /var/db/config on the hard disk. This is useful when you have very large
configurations that might not fit on the CompactFlash card.
71
To specify how many previous versions of the committed configurations you want stored on the
CompactFlash card, include the max-configurations-on-flash statement at the [edit system] hierarchy level:
[edit system]
max-configurations-on-flash number;
RELATED DOCUMENTATION
IN THIS SECTION
You can configure a device to transfer its configuration to an archive file periodically.
To configure the device to transfer its active configuration to an archive site, include statements at the
[edit system archival configuration] hierarchy level:
transfer-interval interval;
transfer-on-commit;
To configure the device to periodically transfer its active configuration to an archive site, include the
transfer-interval statement at the [edit system archival configuration] hierarchy level:
To configure the device to transfer the configuration to an archive site each time you commit the
configuration, include the transfer-on-commit statement at the [edit system archival configuration] hierarchy
level:
When you configure the device to transfer its configuration files, you specify an archive site to which
the files are transferred. If you specify more than one archive site, the device attempts to transfer files to
the first archive site in the list, moving to the next site only if the transfer fails.
When you use the archive-sites statement, you can specify a destination as an FTP URL, HTTP URL, or
SCP-style remote file specification. The URL type file:// is also supported. When you specify the archive
site, do not add a forward slash (/) to the end of the URL.
To configure the archive site, include the archive-sites statement at the [edit system archival configuration]
hierarchy level:
NOTE: When specifying a URL in a statement using an IPv6 host address, you must enclose the
entire URL in quotation marks ("") and enclose the IPv6 host address in brackets ([ ]). For
example, "ftp://username<:password>@[ipv6-host-address]<:port>/url-path"
If the network device reaches the archive server through a specific routing instance, configure the
routing-instance statement at the [edit system archival configuration] hierarchy level, and specify the
routing instance.
The destination filename is saved in the following format, where n corresponds to the number of the
compressed configuration rollback file that has been archived:
<router-name>_YYYYMMDD_HHMMSS_juniper.conf.n.gz
NOTE: The time included in the destination filename is in Coordinated Universal Time (UTC).
Most Juniper Networks devices have a console port and an auxiliary port for connecting terminals to the
router or switch. The console port is enabled by default, and its speed is 9600 baud. The auxiliary port is
disabled by default.
To configure the properties for the console and auxiliary ports, include the ports statement at the [edit
system] hierarchy level:
[edit system]
ports {
auxiliary {
disable;
insecure;
type terminal-type;
}
74
console {
authentication-order;
disable;
insecure;
log-out-on-disconnect;
type terminal-type;
}
}
By default, the terminal type is set to unknown. To change the terminal type, include the type statement,
specifying a terminal-type of ansi, vt100, small-xterm, or xterm. The first three terminal types set a screen size
of 80 columns by 24 lines. The last type, xterm, sets the size to 80 columns by 65 rows.
By default, the console session is not logged out when the data carrier is lost on the console modem
control lines. To change this default and log out the session automatically when the data carrier on the
console port is lost, include the log-out-on-disconnect statement. You can use the show system users
command to verify the console session is logged out.
By default, terminal connections to the console and auxiliary ports are secure. When you configure the
console as insecure, root logins are not allowed to establish terminal connections. In addition,
superusers and anyone with a user identifier (UID) of 0 are not allowed to establish terminal connections
in multiuser mode when you configure the console as insecure. To disable root login connections to the
console and auxiliary ports, include the insecure statement. This option can be used to prevent someone
from attempting password recovery by booting into single-user mode, if they do not know the root
password.
To disable console login, include the disable statement. By default, console login is enabled.
NOTE: For Common Criteria compliance, the console port must be disabled.
RELATED DOCUMENTATION
CHAPTER 5
IN THIS CHAPTER
The primary method of monitoring and troubleshooting Junos OS, routing protocols, network
connectivity, and the device hardware is to enter commands from the CLI. The CLI enables you to
display information in the routing tables and routing protocol-specific data, and to check network
connectivity using ping and traceroute commands.
The J-Web GUI is a Web-based alternative to using CLI commands to monitor, troubleshoot, and
manage the device.
Junos OS includes SNMP software, which enables you to manage routers. The SNMP software consists
of an SNMP master agent and a MIB II agent, and supports MIB II SNMP version 1 traps and version 2
notifications, SNMP version 1 Get and GetNext requests, and version 2 GetBulk requests.
The software also supports tracing and logging operations so that you can track events that occur—both
normal device operations and error conditions—and track the packets that are generated by or pass
through the device. Logging operations use a syslog-like mechanism to record system-wide, high-level
operations, such as interfaces going up or down and users logging in to or out of the device. Tracing
operations record more detailed messages about the operation of routing protocols, such as the various
types of routing protocol packets sent and received, and routing policy actions.
RELATED DOCUMENTATION
Tracing and logging operations allow you to track events that occur in the device—both normal
operations and error conditions—and to track the packets that are generated by or passed through the
device. The results of tracing and logging operations are placed in files in the /var/log directory.
Remote Tracing
Junos OS provides an option to do remote tracing for specific processes, which greatly reduces use of
device internal storage for tracing and is analogous to remote system logging. You configure remote
tracing system-wide using the tracing statement at the [edit system] hierarchy level. By default, remote
tracing is not configured. You can disable remote tracing for specific processes using the no-remote-trace
statement at the [edit process-name traceoptions] hierarchy level. This feature does not alter local tracing
functionality in any way, and logging files are stored on the device.
• chassisd—Chassis-control process
• eventd—Event-processing process
• cosd—Class-of-service process
• spd—Adaptive-services process
To enable system-wide remote tracing, include the destination-override syslog host statement at the [edit
system tracing] hierarchy level. This specifies the remote host running the system log process (syslogd),
which collects the traces. Traces are written to file(s) on the remote host per the syslogd configuration
in /etc/syslog.conf. By default remote tracing is not configured.
To override the system-wide remote tracing configuration for a particular process, include the no-remote-
trace statement at the [edit process-name traceoptions] hierarchy. When no-remote-trace is enabled, the
process does local tracing.
NOTE: When remote tracing is configured, traces will go to the remote host.
To collect traces, use the local0 facility as the selector in /etc/syslog.conf on the remote host. To
separate traces from various processes into different files, include the process name or trace-file name if
it is specified at the [edit process-name traceoptions file] hierarchy level, in the Program field in /etc/
syslog.conf. If your syslog server supports parsing hostname and program name, then you can separate
traces from the various processes.
Logging Operations
77
Logging operations use a system logging mechanism similar to the UNIX syslogd utility to record system-
wide, high-level operations, such as interfaces going up or down and users logging in to or out of the
device. You configure these operations by using the syslog statement at the [edit system] hierarchy level,
as described in Junos OS System Log Overview, and by using the options statement at the [edit routing-
options] hierarchy level, as described in the Junos OS Routing Protocols Library for Routing Devices.
Tracing Operations
Tracing operations record more detailed messages about the operation of routing protocols, such as the
various types of routing protocol packets sent and received, and routing policy actions. You configure
tracing operations using the traceoptions statement. You can define tracing operations in different
portions of the router configuration:
• Global tracing operations: Define tracing for all routing protocols. You define these tracing operations
at the [edit routing-options] hierarchy level of the configuration.
• Protocol-specific tracing operations: Define tracing for a specific routing protocol. You define these
tracing operations in the [edit protocols] hierarchy when configuring the individual routing protocol.
Protocol-specific tracing operations override any equivalent operations that you specify in the global
traceoptions statement. If there are no equivalent operations, they supplement the global tracing
options. If you do not specify any protocol-specific tracing, the routing protocol inherits all the global
tracing operations.
• Tracing operations within individual routing protocol entities: Some protocols allow you to define
more granular tracing operations. For example, in Border Gateway Protocol (BGP), you can configure
peer-specific tracing operations. These operations override any equivalent BGP-wide operations or, if
there are no equivalents, supplement them. If you do not specify any peer-specific tracing
operations, the peers inherit, first, all the BGP-wide tracing operations and, second, the global tracing
operations.
• Interface tracing operations: Define tracing for individual router interfaces and for the interface
process itself. You define these tracing operations at the [edit interfaces] hierarchy level of the
configuration as described in the Junos OS Network Interfaces Library for Routing Devices.
RELATED DOCUMENTATION
Starting with Junos OS Release 14.2, packets that need to be forwarded to the adjacent network
element or a neighboring device along a routing path might be dropped by a device owing to several
factors. Some of the causes for such a loss of traffic or a block in transmission of data packets include
overloaded system conditions, profiles and policies that restrict the bandwidth or priority of traffic,
network outages, or disruption with physical cable faults. You can use a number of show commands to
determine and analyze the statistical counters and metrics related to any traffic loss and take an
appropriate corrective measure. The fields displayed in the output of the show commands help in
diagnosing and debugging network performance and traffic-handling efficiency problems.
The following show commands and associated fields applicable for dropped packets enable you to view
and analyze some of the system parameters for errors or disruption in transmitted packets.
show interfaces extensive—Display input and output packet errors or drops. Following are some of the show
interfaces extensive input counters and their definitions.
Following are definitions for some of the output counters for show interfaces extensive:
Following are definitions for some of the Queue counters for show interfaces extensive (both outbound
and inbound). This includes CoS queue number and its associated user-configured forwarding class
name, and is displayed on IQ2 interfaces.
Drops Number of packets dropped by the input queue of the I/O Manager ASIC. If the
interface is saturated, this number increments once for every packet that is dropped
by the ASIC's RED mechanism.
Framing errors Number of packets received with an invalid frame checksum (FCS).
Runts Number of frames received that are smaller than the runt threshold.
Policed discards Number of frames that the incoming packet match code discarded because they
were not recognized or not of interest. Usually, this field reports protocols that the
Junos OS does not handle.
L3 incompletes Number of incoming packets discarded because they failed Layer 3 (usually IPv4)
sanity checks of the header. For example, a frame with less than 20 bytes of
available IP header is discarded. L3 incomplete errors can be ignored by configuring
the ignore-l3-incompletes statement.
79
L2 channel errors Number of times the software did not find a valid logical interface for an incoming
frame.
L2 mismatch Number of malformed or short packets that caused the incoming packet handler to
timeouts discard the frame as unreadable.
FIFO errors Number of FIFO errors in the receive direction that are reported by the ASIC on the
PIC. If this value is ever nonzero, the PIC is probably malfunctioning.
Carrier Number of times the interface has gone from down to up. This number does not
transitions normally increment quickly, increasing only when the cable is unplugged, the far-
end system is powered down and then up, or another problem occurs. If the number
of carrier transitions increments quickly (perhaps once every 10 seconds), the cable,
the far-end system, or the PIC or PIM is malfunctioning.
Drops Number of packets dropped by the output queue of the I/O Manager ASIC. If the
interface is saturated, this number increments once for every packet that is dropped
by the ASIC's RED mechanism.
Collisions Number of Ethernet collisions. The Gigabit Ethernet PIC supports only full-duplex
operation, so for Gigabit Ethernet PICs, this number should always remain 0. If it is
nonzero, there is a software bug.
Aged packets Number of packets that remained in shared packet SDRAM so long that the system
automatically purged them. The value in this field should never increment. If it does,
it is most likely a software bug or possibly malfunctioning hardware.
FIFO errors Number of FIFO errors in the send direction as reported by the ASIC on the PIC. If
this value is ever nonzero, the PIC is probably malfunctioning.
HS link CRC Number of errors on the high-speed links between the ASICs responsible for
errors handling the router interfaces.
MTU errors Number of packets whose size exceeded the MTU of the interface.
show interfaces queue—Display class-of-service (CoS) queue information for physical interfaces. Following
are some of the show interfaces queue output fields and their definitions.
show class-of-service fabric statistics summary—Display class-of-service (CoS) switch fabric queue drop
statistics. Following are the fabric queue statistics for dropped traffic:
show pfe statistics traffic fpc—Display packet drops related to the entire FPC. Following are the FPC-
level statistics for Packet Forwarding Engine hardware discards:
The following statistics are related to Packet Forwarding Engine local traffic for show pfe statistics traffic
fpc:
Normal discard Number of packets discarded because of discard routes. Packets are dropped
silently without being further processed by the host. Normal discards are
reported when packets match a firewall filter term that has an action of discard
or when the final result of the route look-up is a next hop of discard.
Extended discard Number of packets discarded because of illegal next hops. Packets are dropped
silently but are also sent to the Routing Engine for further processing. Extended
discards are reported when packets match a firewall filter term that has an
action of discard and an additional action that requires Routing Engine
processing, such as log, count, sample, or syslog.
Local packets input Number of incoming packets from the local network.
Local packets output Number of outgoing packets dispatched to a host in the local network.
Software input high Number of incoming software packets of high-priority, dropped during
drops transmission.
Software input low Number of incoming software packets of low-priority, dropped during
drops transmission.
Software output Number of outgoing software packets that were dropped during transmission.
drops
Hardware input Number of incoming hardware packets that were dropped during transmission.
drops
The preceding commands represent only the main parameters that you can use to identify and monitor
traffic drops or errors. Depending on your specific deployment scenario and network conditions, you
might need to view the output of other relevant show commands to evaluate different factors that might
be resulting in traffic transmission losses.
Sometimes you may need to disconnect a user session if it does not terminate after a user logs out, or
you may otherwise want to log a user out for some other reason.
To log a user out of all terminal sessions on a router, enter the following Junos OS CLI command:
The sample output for the first show system users command shows there were two users on the router,
harry and lisa. The request system logout user command was issued to log out user harry. Because there is
no output to indicate that harry was logged out, the show system users command was issued again to
verify that user harry was actually logged out of the router, while the user lisa remains logged in.
83
CHAPTER 6
IN THIS CHAPTER
By default, when an internal Junos OS process generates a core file, the file and associated context
information are saved for debugging purposes in a compressed tar file named process-name.core.core-
number.tgz in the /var/tmp/ and /var/crash/ directories. For Junos OS Evolved, the output is saved in
the /var/core/ directory for Routing Engine core files and /var/lib/ftp/in/ for FPC core files. The
contextual information includes the configuration and system log message files.
To disable the saving of core files and associated context information, include the no-saved-core-context
statement at the [edit system] hierarchy level:
[edit system]
no-saved-core-context;
To save the core files only, include the saved-core-files statement at the [edit system] hierarchy level and
specify the number of files to save:
[edit system]
saved-core-files number;
number is the number of core files to save and can be a value from 1 through 10.
84
To save the core files along with the contextual information, include the saved-core-context statement at
the [edit system] hierarchy level:
[edit system]
saved-core-context;
RELATED DOCUMENTATION
saved-core-context | 135
saved-core-files | 137
Viewing Core Files from Junos OS Processes
When an internal Junos OS process generates a core file, you can find the output at /var/crash/
and /var/tmp/. For Junos OS Evolved, you can find the output core files at /var/core/ for Routing
Engine core files and /var/lib/ftp/in/ for FPC core files. Using these directories provides a quick method
of finding core issues across large networks.
Use the CLI command show system core-dumps to view core files.
RELATED DOCUMENTATION
To disable a software process, specify the appropriate option in the processes statement at the [edit
system] hierarchy level:
[edit system]
processes {
process-name (enable | disable);
}
NOTE: The process-name variable is one of the valid process names. You can obtain a complete list
of process names by using the CLI command completion feature.
RELATED DOCUMENTATION
processes | 124
Configuring Failover to Backup Media If a Junos OS Process Fails | 85
Viewing Core Files from Junos OS Processes
For network devices with redundant Routing Engines, you can configure the device to switch to backup
media that contains a version of the system if a software process fails repeatedly, or to the other
Routing Engine.
To configure automatic switchover to backup media if a software process fails, include the failover
statement at the [edit system processes process-name] hierarchy level. If this statement is configured for a
86
process, and that process fails four times within 30 seconds, the device reboots from either the
alternative media or the other Routing Engine.:
The value for process-name should be one of the valid process names.
RELATED DOCUMENTATION
Configuration data for each process in Junos OS is stored in memory that is mapped within the address
space of each process, requiring a fixed maximum space to be reserved in each process. This scheme
works well until a process is managing many functions at commit time and negatively impacts the
commit time, or simply needs more memory than the default allotment. For example, the rpd process
might be managing many routes and require more space to store important information about the
routes.
In circumstances that require more than the maximum memory-mapped size, you can use virtual-memory-
mapping at the [edit system configuration-database] hierarchy level to make more memory available for the
configuration database per process.
You can configure a portion of virtual memory at a fixed size for the initial portion of the configuration
database, and you can specify an amount to be used for page-pooling. Page-pooling uses a small amount
of memory to bring database pages into memory as needed, rather than mapping the entire
configuration database into the virtual memory space for the process.
3 PART
Configuration Statements | 88
CHAPTER 7
Configuration Statements
IN THIS CHAPTER
backup-router | 89
commit (System) | 90
compress-configuration-files (System) | 93
configuration-database | 95
domain-name | 98
domain-search | 99
fib-local | 101
fib-remote | 102
filter | 103
host-name | 104
inet6-backup-router | 105
memory-enhanced | 109
management-instance | 110
max-configurations-on-flash | 112
mirror-flash-on-disk | 113
non-subscriber-no-reply | 117
no-route-localize | 118
pic-console-authentication | 119
ports | 122
processes | 124
redundancy-interface-process | 127
root-authentication | 129
89
route-localization | 132
saved-core-context | 135
saved-core-files | 137
static-host-mapping | 138
vpn-label | 140
backup-router
IN THIS SECTION
Syntax | 89
Hierarchy Level | 89
Description | 90
Options | 90
Release Information | 90
Syntax
Hierarchy Level
[edit system]
90
Description
Set a default router (running IP version 4 [IPv4]) to use while the local router (running IPv4) is booting
and if the routing protocol processes fail to start. The Junos OS removes the route to this router as soon
as the software starts.
Options
destination (Optional) Destination address that is reachable through the backup router. You can
destination- include this option to achieve network reachability while loading, configuring, and
address
recovering the router, but without the risk of installing a default route in the
forwarding table.
• Default: All hosts (default route) are reachable through the backup router.
Release Information
RELATED DOCUMENTATION
commit (System)
IN THIS SECTION
Syntax | 91
Hierarchy Level | 91
91
Description | 91
Options | 91
Release Information | 93
Syntax
commit {
commit-synchronize-server;
delta-export;
fast-synchronize;
notification;
peers;
peers-synchronize;
persist-groups-inheritance | no-persist-groups-inheritance;
server;
synchronize;
}
The parameters for fast-synchronize and synchronize do not apply for the SRX Series.
Hierarchy Level
[edit system]
Description
Options
delta-export—(Optional) Configure system commit to export only the changes made in the candidate
configuration instead of exporting the entire candidate configuration to the configuration database. This
helps to reduce the time taken to commit the configuration changes..
fast-synchronize—(Optional) Configure commits to run in parallel (simultaneously) on both the primary and
backup Routing Engines to reduce the time required for commit synchronization. The fast-synchronize
configuration is valid only on systems with two Routing Engines. (Option not available for SRX Series.)
peers—(Optional) Specify the host names or IP addresses of the MC-LAG peers and the user
authentication details for the users administering the MC-LAG peers that are participating in commit
synchronization.
NOTE: Starting in Junos OS Release 17.1R1, the peers option at the [edit system commit] hierarchy
level is not supported in batch configuration mode.
synchronize—(Optional) For devices with multiple Routing Engines only. Configure the commit command
to automatically perform a commit synchronize action between dual Routing Engines within the same
chassis. The Routing Engine on which you execute the commit command (the requesting Routing
Engine) copies and loads its candidate configuration to the other (the responding) Routing Engine. Each
Routing Engine then performs a syntax check on the candidate configuration file being committed. If no
errors are found, the configuration is activated and becomes the current operational configuration on
both Routing Engines. (Option not available for SRX Series.)
Release Information
Option no-persist-groups-inheritance added in Junos OS Evolved Release 19.2R1 and Junos OS Release
19.4R1.
RELATED DOCUMENTATION
compress-configuration-files (System)
IN THIS SECTION
Syntax | 94
Hierarchy Level | 94
Description | 94
Default | 94
Options | 94
Release Information | 95
94
Syntax
(compress-configuration-files | no-compress-configuration-files);
Hierarchy Level
[edit system]
Description
Compress the current operational configuration file. By default, the current operational configuration file
is compressed, and is stored in the file juniper.conf, in the /config file system, along with the last three
committed versions of the configuration. However, with large networks, the current configuration file
might exceed the available space in the /config file system. Compressing the current configuration file
allows the file to fit in the file system, typically reducing the size of the file by 90 percent. The current
configuration file is compressed on the second commit of the configuration after the first commit is
made to include the compress-configuration-files statement.
NOTE: We recommend that you enable compression of the router configuration files to minimize
the amount of disk space that they require.
Default
Options
Release Information
RELATED DOCUMENTATION
configuration-database
IN THIS SECTION
Syntax | 95
Hierarchy Level | 96
Description | 96
Options | 96
Release Information | 98
Syntax
configuration-database {
ephemeral {
allow-commit-synchronize-with-gres;
commit-synchronize-model (asynchronous | synchronous);
delete-ephemeral-default;
ignore-ephemeral-default;
instance instance-name;
}
extend-size;
max-db-size max-db-size;
resize {
database-size-diff size MB;
database-size-on-disk size MB;
96
}
virtual-memory-mapping {
process process name {
fixed-size size KB;
page-pooling-size size KB;
}
}
}
Hierarchy Level
[edit system]
Description
Configure the virtual-memory-mapping statement hierarchy to increase the memory space available for the
configuration database size per process, as needed, by using virtual memory mapping and page-pooling.
Configure the ephemeral statement hierarchy to specify options for the ephemeral configuration database.
Configure the resize statement hierarchy when it is necessary to resize the configuration database.
Options
extend-size Increase the memory space available for the configuration database, per process, up to
1.5 GB. The extended default size is based on the original default database size. A device
with a default database size of 409.99 MB will extend to a maximum of 1049.99 MB, and
a device with a default database size of 665.99 MB will extend to a maximum of
1305.99.
97
The extend-size and max-db-size statements are mutually exclusive and cannot be
configured together.
You must reboot the router after committing this statement to make the change effective.
max-db-size Configures the maximum database size. max-db-size and extend-size are mutually exclusive
and cannot be configured together.
resize Resizes the configuration database. The database will be resized automatically during the
commit based on the values specified in the database-size-diff and database-size-on-disk
attributes. The system will display Database resize completed when the configuration
database has been successfully resized.
virtual- Define parameters for using virtual memory mapping for the configuration database on a
memory- per-process basis. You can define a fixed size for the initial portion of the database and
mapping
configure a page-pooling size for the remaining portion of the database. The parameter
process sets the process name, while fixed-size sets the size in kilobytes to directly map for
the initial portion of the configuration database for the specified process and page-pooling-
size sets the size in kilobytes to use for page-pooling the remaining data in the database,
with the valid range being from 512KB to 680MB for each.
Release Information
RELATED DOCUMENTATION
domain-name
IN THIS SECTION
Syntax | 98
Hierarchy Level | 98
Description | 98
Options | 99
Release Information | 99
Syntax
domain-name domain-name;
Hierarchy Level
[edit system]
Description
Configure the name of the domain in which the router or switch is located. This is the default domain
name that is appended to hostnames that are not fully qualified.
99
Options
NOTE: The length of the domain name cannot exceed 255 characters.
Release Information
domain-search
IN THIS SECTION
Syntax | 99
Description | 100
Options | 100
Syntax
domain-search [domain-list ];
100
Hierarchy Level
[edit system],
[edit system services dhcp],
[edit system services dhcp],
[edit system services dhcp pool],
[edit system services dhcp static-binding]
Description
Configure a list of domains to search (in the case where you want to configure access to multiple DNS
servers for redundancy, and/or to resolve hosts that the previous server could not).
Options
domain-list List of domain servers to search. The list can contain up to six domain names, separated by
a space, with a total of up to 256 characters.
For example to search domain1.net, and if it fails to resolve the host, domain2.net, and if fails to resolve the
host, domain3.net, you would configure the following domain list at the domain-search hierarchy level:
[edit system]
set domain-search [domain1.net domain2.net domain3.net]
Release Information
fib-local
IN THIS SECTION
Syntax | 101
Description | 101
Syntax
fib-local;
Hierarchy Level
Description
NOTE: At least, one Packet Forwarding Engine must be configured as fib-local for the commit
operation to be successful. If you do not configure fib-local for the Packet Forwarding Engine, the
CLI displays an appropriate error message and the commit fails.
Release Information
RELATED DOCUMENTATION
fib-remote
IN THIS SECTION
Syntax | 102
Description | 102
Syntax
fib-remote;
Hierarchy Level
Description
Release Information
RELATED DOCUMENTATION
filter
IN THIS SECTION
Syntax | 103
Description | 104
Syntax
filter;
Hierarchy Level
Description
Enables storing of firewall filters across multiple static RAM (SRAM) segments, resulting in proper
utilization of SRAM segments. This feature is useful in routers with small routing tables and large firewall
filters. This statement is supported on T Series routers.
Release Information
RELATED DOCUMENTATION
Allocating More Memory for Routing Tables, Firewall Filters, and Layer 3 VPN Labels
host-name
IN THIS SECTION
Syntax | 105
Description | 105
Options | 105
Syntax
host-name hostname;
Hierarchy Level
[edit system]
Description
Options
Release Information
inet6-backup-router
IN THIS SECTION
Syntax | 106
Description | 106
106
Options | 106
Syntax
Hierarchy Level
[edit system]
Description
Set a default router (running IP version 6 [IPv6]) to use while the local router or switch (running IPv6) is
booting and if the routing protocol processes fail to start. The Junos OS removes the route to this router
or switch as soon as the software starts.
Options
destination (Optional) Destination address that is reachable through the backup router. You can
destination- include this option to achieve network reachability while loading, configuring, and
address
recovering the router or switch, but without the risk of installing a default route in
the forwarding table.
• Default: All hosts (default route) are reachable through the backup router.
Release Information
location (System)
IN THIS SECTION
Syntax | 107
Description | 108
Options | 108
Syntax
location {
altitude feet;
building name;
country-code code;
floor number;
hcoord horizontal-coordinate;
lata transport-area;
latitude degrees;
longitude degrees;
npa-nxx number;
postal-code postal-code;
rack number;
vcoord vertical-coordinate;
}
108
Hierarchy Level
[edit system]
Description
Options
building name Name of building. The name of the building can be 1 to 28 characters in
length. If the string contains spaces, enclose it in quotation marks (" ").
npa-nxx number First six digits of the phone number (area code and exchange).
Release Information
RELATED DOCUMENTATION
memory-enhanced
IN THIS SECTION
Syntax | 109
Description | 110
Syntax
memory-enhanced {
filter;
route;
vpn-label;
}
Hierarchy Level
[edit chassis]
110
Description
Allocate more jtree memory for routing tables and Layer 3 VPNs.
NOTE: The memory-enhanced statement supports MX Series routers with DPC (I-chip based) line
cards only.
Release Information
RELATED DOCUMENTATION
Allocating More Memory for Routing Tables, Firewall Filters, and Layer 3 VPN Labels
management-instance
IN THIS SECTION
Syntax | 111
Description | 111
Options | 111
Syntax
management-instance;
Hierarchy Level
[edit system]
Description
Enable a dedicated management virtual routing and forwarding (VRF) instance. The name of the
dedicated management instance is reserved and hardcoded as mgmt_junos; you cannot configure any other
routing instance by the name mgmt_junos.
The management Ethernet interface (usually named fxp0 or em0) provides the out-of-band management
network for the router. There is no clear separation between either out-of-band management traffic and
in-band protocol control traffic, or user traffic at the routing-instance or routing table level. The
management-instance configuration statement confines the management interface in the dedicated
management instance mgmt_junos, and it enables an administrative routing table dedicated to management
tasks for the network device.
For more information about configuring management-instance and the mgmt_junos routing instance, see
Management Interface in a Non-Default Instance.
Options
Release Information
max-configurations-on-flash
IN THIS SECTION
Syntax | 112
Description | 112
Options | 112
Syntax
max-configurations-on-flash number;
Hierarchy Level
[edit system]
Description
Options
• Range: 0 through 49. The most recently saved configuration is number 0, and the oldest
saved configuration is number 49.
Release Information
RELATED DOCUMENTATION
Using Junos OS to Specify the Number of Configurations Stored on the CompactFlash Card | 70
mirror-flash-on-disk
IN THIS SECTION
Syntax | 113
Description | 114
Options | 114
Syntax
mirror-flash-on-disk;
Hierarchy Level
[edit system]
114
Description
Configure the hard disk to automatically mirror the contents of the CompactFlash card. The hard disk
maintains a synchronized mirror copy of the CompactFlash card contents. Data written to the
CompactFlash card is simultaneously updated in the mirrored copy of the hard disk. If the CompactFlash
card fails to read data, the hard disk automatically retrieves its mirrored copy of the CompactFlash card.
CAUTION: We recommend that you disable flash disk mirroring when you upgrade or
downgrade the router.
You cannot issue the request system snapshot command while the mirror-flash-on-disk
statement is enabled.
NOTE: After you have enabled or disabled the mirror-flash-on-disk statement, you must reboot
the router for your changes to take effect. To reboot, issue the request system reboot command.
Options
Release Information
Statement deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.
NOTE: To determine which platforms run Junos OS with Upgraded FreeBSD, see the table listing
the platforms currently running Junos OS with upgraded FreeBSD in Release Information for
Junos OS with Upgraded FreeBSD.
115
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 115
Description | 116
Options | 116
Syntax
name-server {
address {
routing-instance routing-instance;
}
}
Hierarchy Level
[edit system],
[edit system services dhcp],
[edit system services dhcp],
[edit system services dhcp pool],
[edit system services dhcp static-binding]
116
Description
Options
address Address of the name server. To configure multiple name servers, include a maximum of
three address options.
routing- Configure name of the routing instance through which the name server is reachable.
instance
routing-
instance
NOTE: The only routing instance supported is mgmt_junos. Also, this routing
instance command is not supported on SRX Series devices.
Release Information
routing-instance options introduced in Junos OS Release 19.2R1 under the [edit system] hierarchy level
only.
RELATED DOCUMENTATION
non-subscriber-no-reply
IN THIS SECTION
Syntax | 117
Description | 117
Options | 117
Syntax
non-subscriber-no-reply;
Hierarchy Level
Description
Enable this option to drop ARP requests from non-subscribers when a user route is dynamically added
for a subscriber. Configuring this statement suppresses the ARP response from the kernel when there is
an ARP request for a loopback interface from static DHCP subscribers using a common LAN segment
between two devices. However, this configuration might not be effective if the subscriber configuration
has suppressed either a destination Layer 2 route or an access Layer 3 route.
Options
Release Information
RELATED DOCUMENTATION
autoinstallation
no-route-localize
IN THIS SECTION
Syntax | 118
Description | 119
Syntax
no-route-localize;
Hierarchy Level
Description
Release Information
RELATED DOCUMENTATION
pic-console-authentication
IN THIS SECTION
Syntax | 120
Description | 120
Default | 120
Options | 120
Syntax
pic-console authentication {
(encrypted-password "password");
}
Hierarchy Level
[edit system]
Description
Default
Options
encrypted- Use MD5 or other encrypted authentication. Specify the MD5 or other password. You
password " can specify only one encrypted password.
password"
You cannot configure a blank password for encrypted-password using blank quotation
marks (" "). You must configure a password whose number of characters range from 1
through 128 characters and enclose the password in quotation marks.
Release Information
RELATED DOCUMENTATION
port (Syslog)
IN THIS SECTION
Syntax | 121
Description | 121
Options | 121
Syntax
Hierarchy Level
Description
Options
• Default: 514
Release Information
RELATED DOCUMENTATION
syslog (System)
host (System)
ports
IN THIS SECTION
Syntax | 122
Description | 123
Options | 123
Syntax
ports {
auxiliary {
123
disable;
insecure;
type terminal-type;
port-type (mini-usb | rj45);
}
console {
disable;
insecure;
log-out-on-disconnect;
type terminal-type;
}
}
Hierarchy Level
[edit system]
Description
Configure the properties of the console and auxiliary ports. The ports are located on the router’s craft
interface.
Options
Release Information
RELATED DOCUMENTATION
processes
IN THIS SECTION
Syntax | 124
Description | 124
Default | 125
Options | 125
Syntax
processes {
process-name (enable | disable) failover (alternate-media | other-routing-engine);
timeout seconds;
}
Hierarchy Level
[edit system]
Description
Default
Options
process-name One of the valid process names. You can obtain a complete list of process names by
using the CLI command completion feature. After specifying a process name,
command completion also indicates any additional options for that process.
timeout (Optional) How often the system checks the watchdog timer, in seconds. If the
seconds watchdog timer has not been checked in the specified number of seconds, the system
reloads. If you set the time value too low, it is possible for the system to reboot
immediately after it loads.
Release Information
RELATED DOCUMENTATION
proxy (System)
IN THIS SECTION
Syntax | 126
Description | 126
Options | 127
Syntax
proxy {
server (hostname | ip-address);
port port-number;
username username;
password password;
}
Hierarchy Level
[edit system]
Description
Options
port Set the port number for the proxy server ranging from 0 through 65535.
password Specify the password associated with the username for the proxy server.
Release Information
RELATED DOCUMENTATION
redundancy-interface-process
IN THIS SECTION
Syntax | 128
Description | 128
Options | 128
Syntax
redundancy-interface-process {
command binary-file-path;
disable;
failover (alternate-media | other-routing-engine);
}
Hierarchy Level
Description
Specify as an active or backup process of an application server, configure to process traffic for more than
one logical application server.
Options
failover Configure the device to reboot if the software process fails four times within 30
seconds, and specify the software to use during the reboot.
alternate-media Configure the device to switch to backup media that contains a version of the
system if a software process fails repeatedly.
other-routing- Instruct the secondary Routing Engine to take primary role if a software process
engine fails. If this statement is configured for a process, and that process fails four times
within 30 seconds, then the device reboots from the secondary Routing Engine.
Release Information
root-authentication
IN THIS SECTION
Syntax | 129
Description | 130
Options | 130
Syntax
root-authentication {
encrypted-password "password";
no-public-keys
ssh-ecdsa name {
from from;
}
ssh-ed25519 name {
from from;
}
ssh-rsa name {
from from;
}
}
130
Hierarchy Level
[edit system]
Description
Configure the authentication methods for the root-level user, whose username is root.
You can use the ssh-ecdsa, ssh-ed25519, or ssh-rsa statements to directly configure SSH ECDSA, ED25519,
or RSA keys to authenticate root logins. You can configure more than one public key for SSH
authentication of root logins as well as for user accounts. When a user logs in as root, the public keys are
referenced to determine whether the private key matches any of them.
Options
encrypted-password Specify the MD5 or other password. You can specify only one encrypted
"password" password. You cannot configure a blank password using blank quotation
marks (" "). You must configure a password whose number of characters
range from 1 through 128 characters and enclose the password in quotation
marks.
ssh-ecdsa name from Use an SSH ECDSA public key. You can specify one or more public keys.
from
ssh-ed25519 name Use an SSH ED25519 public key. You can specify one or more public keys.
from from
ssh-rsa name from from Use an SSH RSA public key. You can specify one or more public keys.
Release Information
RELATED DOCUMENTATION
route (chassis)
IN THIS SECTION
Syntax | 131
Description | 131
Syntax
route;
Hierarchy Level
Description
Allocate more jtree memory for routing tables over firewall filters.
Release Information
RELATED DOCUMENTATION
Allocating More Memory for Routing Tables, Firewall Filters, and Layer 3 VPN Labels
route-localization
IN THIS SECTION
Syntax | 132
Description | 132
Options | 133
Syntax
route-localization {
inet;
inet6;
}
Hierarchy Level
[edit chassis]
Description
Options
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 134
Description | 134
Default | 134
Options | 134
Syntax
routing {
force-32-bit | force-64-bit | auto-64-bit;
}
Hierarchy Level
Description
Default
Options
auto-64-bit (Optional) Enable to use 64-bit mode. If the system is 64-bit capable and has at least 16 GB
of RAM, then auto-64-bit will cause the Routing Engine to run in 64-bit mode. Otherwise, it
will run in 32-bit mode.
NOTE: For MX Series routers, virtual private LAN service (VPLS) dynamic profiles
are not supported with the 64-bit mode routing protocol process (rpd). To enable
VPLS dynamic profiles configuration, configure the routing process to use 32-bit
mode.
TIP: You need not restart the routing protocol process (rpd) to use the 64-bit mode. However,
forcing rpd from 32-bit to 64-bit or 64-bit-to 32-bit will restart the rpd process, which can
impact the routing protocols. For this reason, it is recommended to perform these changes in a
maintenance window.
Release Information
RELATED DOCUMENTATION
saved-core-context
IN THIS SECTION
Syntax | 136
136
Description | 136
Options | 136
Syntax
(saved-core-context | no-saved-core-context);
Hierarchy Level
[edit system]
Description
Configure whether the router saves core files generated by internal Junos processes, along with
contextual information (system log files and a copy of the current configuration):
• saved-core-context—The router saves each cores file and its associated context in a compressed tar file
named /var/tmp/process-name.core.core-number.tgz.
• no-saved-core-context—The router does not save cores files and their associated context.
Options
Release Information
RELATED DOCUMENTATION
saved-core-files
IN THIS SECTION
Syntax | 137
Description | 137
Options | 138
Syntax
saved-core-files number;
Hierarchy Level
[edit system]
Description
Save core files generated by internal Junos processes, but not the associated contextual information
(configuration and system log files).
138
Options
number Maximum number of core files to save. The valid range is from 1 through 10.
Release Information
RELATED DOCUMENTATION
static-host-mapping
IN THIS SECTION
Syntax | 139
Description | 139
Default | 139
Options | 139
Syntax
static-host-mapping {
hostname {
alias [ aliases ];
inet [ addresses ];
inet6 [ addresses];
sysid system-identifier;
}
}
Hierarchy Level
[edit system]
Description
(Optional) Statically map a hostname to one or more IP addresses and aliases, and configure an
International Organization for Standardization (ISO) system identifier (system ID).
Default
If you do not statically map the hostname, the mapping is generated dynamically, based on the system
configuration. For instance, if you omit the static-host-mapping hostname sysid statement, the IS-IS system
ID is dynamically generated from the host portion of the ISO address configured on the loopback
interface (lo0) and is mapped to the host-name statement configured at the [edit system] hierarchy level.
Options
inet address IP address. You can specify one or more IP addresses for the host.
sysid system- ISO system identifier (system ID). This is the 6-byte portion of the Intermediate
identifier System-to-Intermediate System (IS-IS) network service access point (NSAP). We
recommend that you use the host’s IP address represented in binary-coded decimal
140
Release Information
vpn-label
IN THIS SECTION
Syntax | 140
Description | 141
Syntax
vpn-label;
Hierarchy Level
Description
Release Information
RELATED DOCUMENTATION
Allocating More Memory for Routing Tables, Firewall Filters, and Layer 3 VPN Labels
142
CHAPTER 8
IN THIS CHAPTER
file archive
IN THIS SECTION
Syntax | 142
Description | 143
Options | 143
Syntax
<exclude> filepattern
<routing-instance>
<source-address>
Description
Archive, and optionally compress, one or multiple local system files as a single file, locally or at a remote
location.
For information on valid filename and URL formats, see "Format for Specifying Filenames and URLs in
Junos OS CLI Commands" on page 67.
Options
destination destination Destination of the archived file or files. Specify the destination as a URL
or filename. The Junos OS adds one of the following suffixes if the
destination filename does not already have it:
source source Source of the original file or files. Specify the source as a URL or
filename.
compress (Optional) Compress the archived file with the GNU zip (gzip)
compression utility. The compressed files have the suffix .tgz.
exclude (Optional) Specify the file pattern to exclude. exclude helps to exclude
files that delay compression or files that need not be compressed.
routing-instance routing- (Optional) Name of the routing-instance.
instance-name
source-address address (Optional) Local address to use in originating the connection.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
144
Sample Output
The following sample command archives all messages files in the local directory /var/log/ as the single
file messages-archive.tar.
user@host>
The following sample command archives a single messages file in the local directory /var/log/ as the
single file messages-archive.tar.
user@host>
The following sample command archives and compresses all messages files in the local directory /var/
log/ as the single file messages-archive.tar.
File Archive Using Secure Copy Protocol (scp) with ’source-address’ and ’routing-instance’
options
To use the scp command to archive a file with the source-address and routing-instance options, enter the
following command:
user@host> file archive source source destination scp:// destination source-address address
routing-instance instance-name
The following sample command archives and compresses all messages files in the local directory /var/
log/ and excludes the single file pattern specified.
Release Information
exclude option added in Junos OS Release 20.3R1 and Junos OS Evolved Release 20.3R1.
RELATED DOCUMENTATION
file compare
IN THIS SECTION
Syntax | 146
Description | 146
Options | 147
Syntax
Description
Compare two local files and describe the differences between them in default, context, or unified output
styles:
• Default—In the first line of output, c means lines were changed between the two files, d means lines
were deleted between the two files, and a means lines were added between the two files. The
numbers preceding this alphabetical marker represent the first file, and the lines after the
alphabetical marker represent the second file. A left angle bracket (<) in front of output lines refers to
the first file. A right angle bracket (>) in front of output lines refers to the second file.
• Context—The display is divided into two parts. The first part is the first file; the second part is the
second file. Output lines preceded by an exclamation point (!) have changed. Additions are marked
with a plus sign (+), and deletions are marked with a minus sign (-).
• Unified—The display is preceded by the line number from the first and the second file (xx,xxx,x).
Before the line number, additions to the file are marked with a plus sign (+), and deletions to the file
147
are marked with a minus sign (-). The body of the output contains the affected lines. Changes are
viewed as additions plus deletions.
Options
none
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
Release Information
RELATED DOCUMENTATION
file copy
IN THIS SECTION
Syntax | 150
Description | 150
Options | 150
Syntax
Description
Copy files from one location to another location on the local device or to a location on a remote device
reachable by the local device.
For information on valid file name and URL formats, see "Format for Specifying Filenames and URLs in
Junos OS CLI Commands" on page 67.
CAUTION: Starting with Junos OS Release 15.1, the sslv3-support option is not available
for configuration with the set system services xnm-ssl and file copy commands. SSLv3 is no
longer supported and available.
For all releases prior to and including Junos OS Release 14.2, SSLv3 is disabled by
default at runtime. The sslv3-support option is hidden and deprecated in Junos OS
Release 14.2 and earlier releases. However, you can use the set system services xnm-ssl
sslv3-support command to enable SSLv3 for a Junos XML protocol client application to
use as the protocol to connect to the Junos XML protocol server on a router, and you
can use the file copy source destination sslv3-support command to enable the copying of
files from an SSLv3 URL.
Using SSLv3 presents a potential security vulnerability, and we recommend that you not
use SSLv3. For more details about this security vulnerability, see the Juniper Networks
Knowledge Base articlehere.
NOTE: If you define an ordered set of ciphers, key exhange methods, or message authentication
codes (MACs) at the [edit system services ssh] hierarchy level, the newly-defined set is used when
copying files using secure copy protocol (scp). For more information, see Configuring the SSH
Service to Support Legacy Cryptography.
Options
source-addresssource-address (Optional) Specify the local address to use in originating the connection.
NOTE: If you are using a literal IPv6 address in your command entry, the address must be
enclosed in [ ] brackets. This conforms to RFC 2732.
maintenance
Sample Output
The following sample command copies a configuration file from Routing Engine 0 to Routing Engine 1:
You can use FTP with the file copy command for additional privacy. You will be prompted for a
password. The password will display using * symbols when viewing interactive logs. Enter the following
command to enable FTP:
In the following example, /config/juniper.conf is the local file and hostname is the FTP server:
NOTE: Starting in Junos OS Evolved release 22.2R2, the password prompt has changed from
Password for user@hostname: to Password:
Release Information
RELATED DOCUMENTATION
file list
IN THIS SECTION
Syntax | 153
Description | 153
Options | 153
Syntax
Description
Options
none Display a list of files in the default directory. The default directory is the home directory of
the user logged in to the router or switch.
detail (Optional) Display detailed information about the files. The output is similar to what is
displayed by the Linux ls -l command.
recursive (Optional) Display detailed information about the files in the directory and all subdirectories
below it.
path (Optional) List the files in a specified directory path. The path name cannot contain any
special characters (![ =;|(){}]).
154
Additional Information
To view available directories, enter a space and then a slash (/) after the file list command. To view files
within a specific directory, include a slash followed by the directory and, optionally, subdirectory name
after the file list command.
maintenance
Sample Output
file list
/var/tmp:
trace_debug
package.log
pics/
downloads/
The following command lists detailed information about the contents of the /var/tmp directory.
/var/tmp/:
total blocks: 4276224
-rw-r--r-- 1 user group 1362 Oct 16 11:11 trace_debug
-rw-r--r-- 1 user group 108 Aug 9 2016 package.log
drwxrwxrwx 2 user group 512 Jun 30 2016 pics/
drwxr-xr-x 3 user group 512 Aug 9 2016 downloads/
total files: 2
155
The following command lists detailed information about the contents of the /var/tmp directory and all
subdirectories below it.
/var/tmp/:
total blocks: 4276224
-rw-r--r-- 1 user group 1362 Oct 16 11:11 trace_debug
-rw-r--r-- 1 user group 108 Aug 9 2016 package.log
drwxrwxrwx 2 user group 512 Jun 30 2016 pics/
drwxr-xr-x 3 user group 512 Aug 9 2016 downloads/
total files: 2
/var/tmp/pics:
total blocks: 5120461
-rw-r--r-- 1 user group 1910 Oct 15 2016 image3.png
-rw-r--r-- 1 user group 1852 Oct 15 2016 image2.png
-rw-r--r-- 1 user group 1310 Aug 9 2016 image1.png
total files: 3
/var/tmp/downloads:
total blocks: 24
-rw-r--r-- 1 user group 108 Aug 21 2016 package2.log
-rw-r--r-- 1 user group 108 Aug 9 2016 package1.log
drwxr-xr-x 2 user group 512 Aug 9 2016 sub-download/
total files: 2
/var/tmp/downloads/sub-download:
total blocks: 16
total files: 0
Release Information
file rename
IN THIS SECTION
Syntax | 156
Description | 156
Options | 156
Syntax
Description
Options
source Original name of the file. For a routing matrix, the filename must include the chassis
information.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
157
Sample Output
file rename
The following example lists the files in /var/tmp, renames one of the files, and then displays the list of
files again to reveal the newly named file.
The following example lists the files in /var/tmp, renames one of the files, and then displays the list of
files again to reveal the newly named file.
/var/tmp:
.pccardd
sartre.conf
snmpd
syslogd.core-tarball.0.tgz
--------------------------------------------------------------------------
/var/tmp:
.pccardd
sartre.conf
snmpd.rr
syslogd.core-tarball.0.tgz
Release Information
file show
IN THIS SECTION
Syntax | 158
Description | 158
Options | 159
Syntax
Description
Options
filename Name of a file. For a routing matrix, the file name must include the chassis
information.
encoding (base64 | (Optional) Encode file contents with base64 encoding or show raw text.
raw)
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
file show
####################################################################
# Basic stuff
####################################################################
define msgbuf
printf "%s", msgbufp->msg_ptr
end
# hex dump of a block of memory
# usage: dump address length
define dump
p $arg0, $arg1
set $ch = $arg0
set $j = 0
set $n = $arg1
while ($j < $n)
#printf "%x %x ",&$ch[$j],$ch[$j]
printf "%x ",$ch[$j]
set $j = $j + 1
if (!($j % 16))
printf "\n"
end
end
end
Release Information
CHAPTER 9
IN THIS CHAPTER
IN THIS SECTION
Syntax | 162
Description | 163
Options | 163
Syntax
Description
Clear any pending system software reboots or halts. When issued on a TX Matrix router without any
options, the default behavior clears all pending system software reboots or halts on all T640 routers
connected to the TX Matrix router. When issued on a TX Matrix Plus router without any options, the
default behavior clears all pending system software reboots or halts on all T1600 or T4000 routers
connected to the TX Matrix Plus router.
Options
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Clear all halt or
reboot requests for all the Routing Engines in the chassis.
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, clear all halt or reboot requests for all T640 routers (or line-card chassis)
164
connected to the TX Matrix router. On a TX Matrix Plus router, clear all halt or
reboot requests on the l connected T1600 or T4000 LCCs.
all-members (EX4200 switches only) (Optional) Clear all halt or reboot requests on all members
of the Virtual Chassis configuration.
both-routing- (Systems with multiple Routing Engines) (Optional) Clear all halt or reboot requests
engines on both Routing Engines. On a TX Matrix router, clear both Routing Engines on all
chassis connected to the TX Matrix router. Likewise, on a TX Matrix Plus router,
clear both Routing Engines on all chassis connected to the TX Matrix Plus router.
infrastructure (QFabric systems) (Optional) Clear all halt or reboot requests on the fabric control
name Routing Engines or fabric manager Routing Engines.
interconnect- (QFabric systems) (Optional) Clear all halt or reboot requests on the Interconnect
device name device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, clear all halt or reboot requests for a specific T640 router that is connected
to the TX Matrix router. On a TX Matrix Plus router, clear all halt or reboot requests
for a specific router that is connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
local (EX4200 switches only) (Optional) Clear all halt or reboot requests on the local
Virtual Chassis member.
member member- (EX4200 switches only) (Optional) Clear all halt or reboot requests on the specified
id member of the Virtual Chassis configuration. Replace member-id with a value from 0
through 9.
node-group name (QFabric systems) (Optional) Clear all halt or reboot requests on the Node group.
165
scc (TX Matrix routers only) (Optional) Clear all halt or reboot requests for the TX
Matrix router (or switch-card chassis).
sfc number (TX Matrix Plus routers only) (Optional) Clear all halt or reboot requests for the TX
Matrix Plus router. Replace number with 0.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 166
Description | 167
Options | 167
Syntax
<backoff-duration seconds>
<collect-core>
<cpu-threshold percentage>
<logical-system>
<num-snapshots number>
<polling-frequency frequency>
Description
Enable flight recorder tool to collect snapshots of historical data on when the CPU utilization for the
routing protocol process on a device was high and what processes caused the high utilization. The
detection of high CPU usage enables faster resolution of issues.
The recorded snapshots and core files are saved as log files in a folder under the /var/log/
flight_recorder/ directory. The log files are listed in the order of time stamp saved. The folder format is
Flr_MONTH_DD_YYYY_HH:MM:SS; for example, Flr_May_09_2018_02:20:50. Each log file in the directory includes the
following information:
• Output from the show task accounting detail command (after enabling and waiting for 10 seconds).
Options
none Enable flight recorder tool to collect snapshots of data used for detecting high CPU
utilization. The recorded snapshots and core files are saved as log files in a folder
under the /var/log/flight_recorder/.
disable Disable flight recorder tool that has been enabled using the request flight-recorder set
high-cpu command.
• Default: Disabled.
backoff- (Optional) Specify the time interval in seconds between two snapshots of data.
duration
seconds • Default: 100 seconds.
collect-core (Optional) Perform snapshot collection of the running core with every snapshot of
data taken.
168
When the collect-core option is enabled, the data snapshots are stored in a separate
core log file in a folder under the /var/log/flight_recorder/ directory. The folder
format is Flr_MONTH_DD_YYYY_HH:MM:SS; for example, Flr_May_09_2018_02:20:50.
• Default: Disabled.
cpu-threshold (Optional) Specify the maximum value of CPU utilization in percentage, beyond which
percentage the collection of data is triggered.
• Default: 80
• Default: Disabled.
num-snapshots (Optional) Specify the number of snapshots of data to be collected before quitting the
number collection process.
• Default: 0
• Range: 1 through 20
polling- (Optional) Specify the time in seconds for polling for high CPU utilization.
frequency
seconds • Default: 10 seconds.
root
Output Fields
When you enter this command, you are provided feedback on the status of your request.
169
Sample Output
Release Information
RELATED DOCUMENTATION
request message
IN THIS SECTION
Syntax | 170
Description | 170
170
Options | 170
Syntax
Description
Display a message on the screens of all users who are logged in to the router or switch or on specific
screens.
Options
all Display a message on the terminal of all users who are currently logged in.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
171
Sample Output
Release Information
IN THIS SECTION
Syntax | 171
Description | 172
Options | 172
Syntax
Description
You might require to perform a resizing of the configuration database as a result of performing frequent
load replacement operations which replaces the configuration hierarchy with the new configuration.
When this occurs, deleted objects store in the database, and the memory allocated in the database is
freed after the commit is completed. However, during this process the database size on disk can grow
although the actual configuration size is actually less.
The request system configuration database resize command provides you with a manual method to resize the
configuration database. The system will display Database resize completed when the configuration database
has been successfully resized.
Use the show system configuration database usage command to display configuration database disk space
usage statistics. The Current database size on disk field will display the change in database size related
to the use of the resize command. See show system configuration database usage.
Options
force (Optional) If there are uncommitted changes and you execute the request system configuration
database resize command, the command will fail and an error will be generated (error:
Database resize failed, Configuration Database Modified.). To execute the command when this
occurs, use the force option to discard the uncommitted changes.
re0 | re1 (Optional) If a router has dual Routing Engines, re0 and re1 identify the specific routing
engine that is to execute the request system configuration database resize command. re0 is for
the Routing Engine in slot 0 and re1 is for the Routing Engine in slot 1.
routing- (Optional) To execute the request system configuration database resize command on a specific
engine routing engine, or on both routing engines, in a redundant configuration you can specify
one of the following:
Additional Information
Include below is a set of usage guidelines when using the request system configuration database resize
command:
• All other configuration sessions will be closed on the routing engine to remove the old mappings to
the configuration database.
• Do not execute the request system configuration database resize command when a commit is in progress.
• During the time when the request system configuration database resize command is in progress, a new
configuration session cannot be opened. A warning message will appear instructing you that the
configuration database is being resized (warning: Database is being resized).
• If there are uncommitted changes and the command is executed, the command will fail and an error
will be generated (error: Database resize failed, Configuration Database Modified.). To execute the
command when this occurs, use the force option to discard the uncommitted changes.
• To execute the command on both routing engines use the request system configuration database resize
routing-engine both command.
• Do not terminate the command when it is in progress (for example, by specifying Ctrl+c or Ctrl+z).
maintenance
Output Fields
Sample Output
Release Information
IN THIS SECTION
Syntax | 175
Description | 177
Options | 177
Syntax
Description
NOTE: When you issue this command on an individual component—for example, a Node device
—in a QFabric system, you will receive a warning that says “Hardware-based members will halt,
Virtual Junos Routing Engines will reboot.” If you want to halt only one member of a Node group,
issue this command with the member option on the Node device CLI, because you cannot issue this
command from the QFabric CLI. Also, issuing this command might cause traffic loss on an
individual component.
When you issue this command on a QFX5100 switch, you are not prompted to reboot. You must
power cycle the switch to reboot.
NOTE: For the routers with the Routing Engines RE-S-2x00x6, RE-PTX-2x00x8, and RE-
S-2x00x8, this command is deprecated and might be removed completely in a future release.
On these routers, this command is replaced with the request vmhost halt command which provides
similar functionality.
Options
at time (Optional) Time at which to stop the software, specified in one of the following
ways:
backup-routing- (Optional) Halt the backup Routing Engine. This command halts the backup Routing
engine Engine, regardless from which Routing Engine the command is executed. For
example, if you issue the command from the primary Routing Engine, the backup
178
Routing Engine is halted. If you issue the command from the backup Routing Engine,
the backup Routing Engine is halted.
in minutes (Optional) Number of minutes from now to stop the software. This option is an alias
for the at +minutes option.
media (compact- (SRX Series only) (Optional) Boot media for the next boot.
flash | disk | usb)
• compact-flash— Standard boot from a flash device.
member (Optional) Halt the specified member of the Virtual Chassis configuration. For an MX
member-id Series Virtual Chassis, member-id can only be 0 or 1.
message "text" (Optional) Message to display to all system users before stopping the software.
other-routing- (Optional) Halt the other Routing Engine from which the command is issued. For
engine example, if you issue the command from the primary Routing Engine, the backup
Routing Engine is halted. Similarly, if you issue the command from the backup
Routing Engine, the primary Routing Engine is halted.
slice slice (EX Series and QFX Series switches only) (Optional) Halt a partition on the boot
media. This option has the following suboptions:
• 1—Halt partition 1.
179
• 2—Halt partition 2.
Additional Information
On the M7i router, the request system halt command does not immediately power down the Packet
Forwarding Engine. The power-down process can take as long as 5 minutes.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
Shutdown NOW!
[pid 7560]
user@host> Dec 8 08:57:37 Waiting (max 60 seconds) for system process `vnlru' to stop...done
Waiting (max 60 seconds) for system process `vnlru_mem' to stop...done
Waiting (max 60 seconds) for system process `bufdaemon' to stop...done
Waiting (max 60 seconds) for system process `syncer' to stop...
Syncing disks, vnodes remaining...2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 done
The following example, which assumes that the time is 5 PM (1700), illustrates three different ways to
request that the system stop 2 hours from now:
To stop the system at 1:20 AM, enter the following command. Because 1:20 AM is the next day, you
must specify the absolute time.
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 182
Description | 182
Options | 182
Syntax
Description
Log out users from the router or switch and the configuration database. If a user held the configure
exclusive lock, this command clears the exclusive lock.
Options
all (Optional) Log out all sessions owned by a particular PID, terminal session, or user.
(On a TX Matrix or TX Matrix Plus router, this command is broadcast to all chassis.)
pid pid Log out the user session using the specified management process identifier (PID).
The PID type must be management process.
terminal Log out the user for the specified terminal session.
terminal
user username Log out the specified user.
configure
Output Fields
When you enter this command, you are provided feedback on the status of your request.
183
Sample Output
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 184
Description | 184
Options | 184
Syntax
Description
Terminate a previously scheduled storage media partition operation. If the command is issued between
the time of a partition request and a reboot, the partition request is terminated and the storage media is
not affected.
Options
all-chassis (TX Matrix and TX Matrix Plus routers only) (Optional) Terminate a previously scheduled
partition operation for all chassis.
all-lcc (TX Matrix and TX Matrix Plus routers only) (Optional) On a TX Matrix router, terminate
a previously scheduled partition operation on all T640 routers ( line-card chassis)
connected to the TX Matrix router. On a TX Matrix Plus router, terminate a previously
185
all-members (MX Series routers only) (Optional) Terminate a previously scheduled partition operation
for all members of the Virtual Chassis configuration.
lcc number (TX Matrix and TX Matrix Plus routers only) (Optional) On a TX Matrix Plus router,
terminate a previously scheduled partition operation on a specific T640 router that is
connected to the TX Matrix router. On a TX Matrix Plus router, terminate a previously
scheduled partition operation on a specific router that is connected to the TX Matrix
Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D
SIBs in a routing matrix.
local (MX Series routers only) (Optional) Terminate a previously scheduled partition operation
for the local Virtual Chassis member.
member (MX Series routers only) (Optional) Terminate a previously scheduled partition operation
member-id for the specified member of the Virtual Chassis configuration. Replace member-id with a
value of 0 or 1.
scc (TX Matrix routers only) (Optional) Terminate a previously scheduled partition operation
on the TX Matrix router (or switch-card chassis).
sfc number (TX Matrix Plus routers only) (Optional) Terminate a previously scheduled partition
operation on the TX Matrix Plus router (or switch-fabric chassis). Replace number with 0.
maintenance
186
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
Command deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.
NOTE: To determine which platforms run Junos OS with Upgraded FreeBSD, see the table listing
the platforms currently running Junos OS with upgraded FreeBSD in Release Information for
Junos OS with Upgraded FreeBSD.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 187
Description | 188
Options | 188
Syntax
Description
Set up the hard disk for partitioning. After this command is issued, the hard disk is partitioned the next
time the system is rebooted. When the hard disk is partitioned, the contents of /altroot and /altconfig
are saved and restored. All other data on the hard disk is at risk of being lost.
Options
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Schedule a partition of the
hard disk for all routers in the chassis at its next reboot.
all-lcc (TX Matrix and TX Matrix Plus routers only) (Optional) On a TX Matrix router, schedule a
partition of the hard disk on all T640 routers connected to the TX Matrix router at their
next reboot. On a TX Matrix Plus router, schedule a partition of the hard disk on all
connected LCCs.
all-members (MX Series routers only) (Optional) Schedule a partition of the hard disk for all members
of the Virtual Chassis configuration.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix Plus
router, schedule a partition of the hard disk on a specific T640 router connected to the
TX Matrix router. On a TX Matrix Plus router, schedule a partition of the hard disk on a
specific router that is connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D
SIBs in a routing matrix.
local (MX Series routers only) (Optional) Schedule a partition of the hard disk for the local
member of the Virtual Chassis.
member (MX Series routers only) (Optional) Schedule a partition of the hard disk for the specified
member-id member of the Virtual Chassis configuration. Replace member-id with a value of 0 or 1.
189
scc (TX Matrix routers only) (Optional) Schedule a partition of the hard disk on the T640
router connected to the TX Matrix router (or switch-card chassis).
sfc number (TX Matrix Plus routersonly) (Optional) Schedule a partition of the hard disk on the
connected T1600 or T4000 LCCs connected to the TX Matrix Plus router . Replace number
with 0.
Additional Information
To immediately partition the hard disk, use the request system reboot command. To cancel the partition
request, use the request system partition abort command.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
Command deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.
NOTE: To determine which platforms run Junos OS with Upgraded FreeBSD, see the table listing
the platforms currently running Junos OS with upgraded FreeBSD in Release Information for
Junos OS with Upgraded FreeBSD.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 191
Description | 193
Options | 193
Syntax
Description
NOTE: When you issue this command on an individual component in a QFabric system, you will
receive a warning that says “Hardware-based members will halt, Virtual Junos Routing Engines
will reboot.” If you want to halt only one member, use the member option. You cannot issue this
command from the QFabric CLI.
NOTE: For a standalone chassis (such as MX Series, PTX Series, and T Series routers), the request
to power off the system is applicable only to the Routing Engines. When you request to power
off both Routing Engines, all the FPCs in the chassis shut down after approximately 10 minutes
and the chassis fans run at full speed. The FPCs shut down because they no longer have
communication with the Routing Engines and an Inter-Integrated Circuit (l2C) timeout occurred.
NOTE: For the routers with Routing Engines RE-S-2x00x6, RE-PTX-2x00x8, and RE-S-2x00x8,
this command is deprecated and might be removed completely in a future release.
On these routers, this command is replaced with the request vmhost power-off command which
provides similar functionality.
Options
all-chassis (Optional) (TX Matrix and TX Matrix Plus router only) Power off all Routing Engines in
the chassis.
all-lcc (Optional) (TX Matrix and TX Matrix Plus router only) On a TX Matrix router, power off
all T640 routers (or line-card chassis) connected to the TX Matrix router. On a TX
Matrix Plus router, power off all T1600 routers (or line-card chassis) connected to the
TX Matrix Plus router.
all-members (EX4200 switches and MX Series routers only) (Optional) Power off all members of the
Virtual Chassis configuration.
at time (Optional) Time at which to power off the software, specified in one of the following
ways:
194
• hh:mm—Absolute time on the current day at which to power off the software.
both-routing- (Optional) Power off both Routing Engines at the same time.
engines
in minutes (Optional) Number of minutes from now to power off the software. This option is an
alias for the at +minutes option.
lcc number (Optional) (TX Matrix and TX Matrix Plus router only) On a TX Matrix router, power off
a T640 router that is connected to the TX Matrix router. On a TX Matrix Plus router,
power off a specific router that is connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D
SIBs in a routing matrix.
local (EX4200 switches and MX Series routers only) (Optional) Power off the local Virtual
Chassis member.
member (EX4200 switches and MX Series routers only) (Optional) Power off the specified
member-id member of the Virtual Chassis configuration. For EX4200 switches, replace member-id
with a value from 0 through 9. For an MX Series Virtual Chassis, replace member-id with a
value of 0 or 1.
message (Optional) Message to display to all system users before powering off the software.
"text"
other- (Optional) Power off the other Routing Engine from which the command is issued. For
routing- example, if you issue the command from the primary Routing Engine, the backup
engine
Routing Engine is halted. Similarly, if you issue the command from the backup Routing
Engine, the primary Routing Engine is halted.
scc (Optional) (TX Matrix router only) Power off only the primary Routing Engine or the
backup Routing Engine on the TX Matrix router (or switch-card chassis). If you issue the
command from the primary Routing Engine, the primary SCC is powered off. If you issue
the command from the backup Routing Engine, the backup SCC is powered off.
sfc number (Optional) (TX Matrix Plus router only) Power off only the primary Routing Engine or the
backup Routing Engine on the TX Matrix Plus router (or switch-fabric chassis). If you
issue the command from the primary Routing Engine, the primary SFC is powered off. If
you issue the command from the backup Routing Engine, the backup SFC is powered
off. Replace number with zero.
slice slice (EX Series and QFX Series switches only) (Optional) Power off a partition on the boot
media. This option has the following suboptions:
Additional Information
On a routing matrix composed of a TX Matrix router and T640 routers, if you issue the request system
power-off command on the TX Matrix primary Routing Engine, all the primary Routing Engines connected
to the routing matrix are powered off. If you issue this command on the backup Routing Engine, all the
backup Routing Engines connected to the routing matrix are powered off.
Likewise, on a routing matrix composed of a TX Matrix Plus router and T1600 routers, if you issue the
request system power-off command on the TX Matrix Plus primary Routing Engine, all the primary Routing
Engines connected to the routing matrix are powered off. If you issue this command on the backup
Routing Engine, all the backup Routing Engines connected to the routing matrix are powered off.
196
If you issue the request system power-off both-routing-engines command on the TX Matrix or TX Matrix Plus
router, all the Routing Engines on the routing matrix are powered off.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
user@host> request system power-off message “This router will be powered off in 30 minutes.
Please save your data and log out immediately.”
warning: This command will not halt the other routing-engine.
If planning to switch off power, use the both-routing-engines option.
Power Off the system ? [yes,no] (no) yes
This router will be powered off in 30 minutes. Please save your data and log out
immediately.
Shutdown NOW!
[pid 5177]
Release Information
IN THIS SECTION
Syntax | 197
Description | 197
Options | 197
Syntax
Description
Terminate any process that you specify with the process identification number (process ID or pid). The
request system process terminate command is an alternative to using the restart command. The restart
command terminates and restarts a process that you specify by process name, but limits you to only
certain well-known processes.
Use the show system processes command to display a list of processes by process ID.
Options
maintenance
Output Fields
When you enter this command, you are not provided feedback on the status of your request. You can
use the show system processes extensive command to confirm the process that was terminated.
Sample Output
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 199
Syntax (MX Series Routers and MX Series Virtual Chassis, EX9200 Switches and EX9200 Virtual
Chassis) | 200
Syntax (QFX Series Switches and QFX Series Virtual Chassis, Virtual Chassis Fabric) | 200
199
Description | 201
Options | 202
Syntax
Syntax (MX Series Routers and MX Series Virtual Chassis, EX9200 Switches and
EX9200 Virtual Chassis)
Syntax (QFX Series Switches and QFX Series Virtual Chassis, Virtual Chassis Fabric)
<message “text”>
<slice slice>
Description
This command can be used on standalone devices and on devices supported in a Virtual Chassis, Virtual
Chassis Fabric, or QFabric system.
Starting with Junos OS Release 15.1F3, the request system reboot command reboots only the guest
operating system on the PTX5000 with RE-PTX-X8-64G and, MX240, MX480, and MX960 with RE-S-
X6-64G.
Starting with Junos OS Release 15.1F5, the request system reboot command reboots only the guest
operating system on the MX2010, and MX2020 with REMX2K-X8-64G.
202
Starting from Junos OS Release 17.2R1, PTX10008 routers do not support the request system reboot
command. Starting from Junos OS Release 17.4R1, PTX10016 routers do not support the request system
reboot command. Use the request vmhost reboot command instead of the request system reboot command on
the PTX10008 and PTX10016 routers to reboot the Junos OS software package or bundle on the
router. See request vmhost reboot.
Starting from Junos OS Release 19.1R1, the PTX10002-60C router and the QFX10002-60C switch do
not support the request system reboot command. Use the request vmhost reboot command instead of the
request system reboot command on these devices to reboot the Junos OS software package or bundle on
the device. See request vmhost reboot.
On a QFabric system, to avoid traffic loss on the network Node group, switch mastership of the Routing
Engine to the backup Routing Engine, and then reboot.
Options
The options described here are not all supported on every platform or release of Junos OS. Refer to the
Syntax sections for the options commonly available on each type of platform.
all-chassis (Optional) On a TX Matrix router or TX Matrix Plus router, reboot all routers
connected to the TX Matrix or TX Matrix Plus router, respectively.
all-lcc (Optional) On a TX Matrix router or TX Matrix Plus router, reboot all line card chassis
connected to the TX Matrix or TX Matrix Plus router, respectively.
• local—Reboots only the local switch (switch where you are logged in).
at time (Optional) Time at which to reboot the software, specified in one of the following
ways:
• hh:mm—Absolute time on the current day at which to stop the software, specified in
24-hour time.
hypervisor (Optional) Reboot Junos OS, host OS, and any installed guest VMs.
in minutes (Optional) Number of minutes from now to reboot the software. The minimum value
is 1. This option is an alias for the at +minutes option.
in-service (Optional) Enables you to reset the software state (no software version change) of the
system with minimal disruption in data and control traffic.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
media (Optional) Use the indicated boot medium for the next boot.
(compact-flash |
disk |
removable-
compact-flash |
usb)
media (external (Optional) Use the indicated boot medium for the next boot:
| internal)
• external—Reboot the device using a software package stored on an external boot
source, such as a USB flash drive.
204
message "text" (Optional) Message to display to all system users before stopping or rebooting the
software.
network (Optional) Reboot using the Preboot Execution Environment (PXE) boot method over
the network.
oam (Optional) Reboot from the maintenance volume (OAM volume, usually the compact
flash drive).
other-routing- (Optional) Reboot the other Routing Engine from which the command is issued. For
engine example, if you issue the command from the primary Routing Engine, the backup
Routing Engine is rebooted. Similarly, if you issue the command from the backup
Routing Engine, the primary Routing Engine is rebooted.
partition (Optional) Reboot using the specified partition on the boot media. This option is
partition equivalent to the slice option that is supported on some devices. Specify one of the
following partition values:
scc (Optional) Reboot the Routing Engine on the TX Matrix switch-card chassis. If you
issue the command from re0, re0 is rebooted. If you issue the command from re1, re1
is rebooted.
sfc number (Optional) Reboot the Routing Engine on the TX Matrix Plus switch-fabric chassis. If
you issue the command from re0, re0 is rebooted. If you issue the command from re1,
re1 is rebooted. Replace number with 0.
slice slice (Optional) Reboot using the specified partition on the boot media. This option was
originally the partitiion option but was renamed to slice on EX Series and QFX Series
switches. Specify one of the following slice values:
• alternate—Reboot from the alternate partition (which did not boot the switch at
the last bootup).
205
NOTE: The slice option is not supported on QFX Series switches that have no
alternate slice when Junos OS boots as a Virtual Machine (VM). To switch to
the previous version of Junos OS, issue the request system software rollback
command.
all (Optional) Reboots the software on the Director group, fabric control Routing Engines,
fabric manager Routing Engines, Interconnect devices, and network and server Node
groups.
director-device (Optional) Reboots the software on the Director device and the default partition
name (QFabric CLI).
director-group (Optional) Reboots the software on the Director group and the default partition
(QFabric CLI).
fabric (Optional) Reboots the fabric control Routing Engines and the Interconnect devices.
node-group (Optional) Reboots the software on a server Node group or a network Node group.
name
graceful (Optional) Enables the QFabric component to reboot with minimal impact to network
traffic. This sub-option is only available for the all, fabric, anddirector-group options.
Additional Information
Reboot requests are recorded in the system log files, which you can view with the show log command (see
show log). Also, the names of any running processes that are scheduled to be shut down are changed.
You can view the process names with the show system processes command (see "show system processes"
on page 313).
On a TX Matrix or TX Matrix Plus router, if you issue the request system reboot command on the primary
Routing Engine, all the primary Routing Engines connected to the routing matrix are rebooted. If you
issue this command on the backup Routing Engine, all the backup Routing Engines connected to the
routing matrix are rebooted.
206
NOTE: Before issuing the request system reboot command on a TX Matrix Plus router with no
options or the all-chassis, all-lcc, lcc number, or sfc options, verify that primary Routing Engine for
all routers in the routing matrix are in the same slot number. If the primary Routing Engine for a
line-card chassis is in a different slot number than the primary Routing Engine for a TX Matrix
Plus router, the line-card chassis might become logically disconnected from the routing matrix
after the request system reboot command.
NOTE: To reboot a router that has two Routing Engines, reboot the backup Routing Engine (if
you have upgraded it) first, and then reboot the primary Routing Engine.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
The following example, which assumes that the time is 5 PM (17:00), illustrates three different ways to
request the system to reboot in two hours:
To reboot the system at 1:20 AM, enter the following command. Because 1:20 AM is the next day, you
must specify the absolute time.
warning: Do NOT use /user during ISSR. Changes to /user during ISSR may get lost!
Current image is jinstall-jcp-i386-flex-18.1.img
[Feb 22 02:37:14]:ISSU: Preparing Backup RE
Prepare for ISSR
[Feb 22 02:37:19]:ISSU: Backup RE Prepare Done
Spawning the backup RE
Spawn backup RE, index 1 successful
Starting secondary dataplane
Second dataplane container started
GRES in progress
Waiting for backup RE switchover ready
GRES operational
Copying home directories
Copying home directories successful
Initiating Chassis In-Service-Upgrade for ISSR
Chassis ISSU Started
[Feb 22 02:42:55]:ISSU: Preparing Daemons
[Feb 22 02:43:00]:ISSU: Daemons Ready for ISSU
[Feb 22 02:43:05]:ISSU: Starting Upgrade for FRUs
[Feb 22 02:43:15]:ISSU: FPC Warm Booting
[Feb 22 02:44:16]:ISSU: FPC Warm Booted
[Feb 22 02:44:27]:ISSU: Preparing for Switchover
[Feb 22 02:44:31]:ISSU: Ready for Switchover
Checking In-Service-Upgrade status
Item Status Reason
FPC 0 Online (ISSU)
Send ISSR done to chassisd on backup RE
Chassis ISSU Completed
Removing dcpfe0 eth1 128.168.0.16 IP
Bringing down bme00
Post Chassis ISSU processing done
[Feb 22 02:44:33]:ISSU: IDLE
Stopping primary dataplane
Clearing ISSU states
Console and management sessions will be disconnected. Please login again.
device_handoff successful ret: 0
Shutdown NOW!
[pid 14305]
209
Release Information
Option sfc introduced for the TX Matrix Plus router in Junos OS Release 9.6.
Option partition changed to slice in Junos OS Release 10.0 for EX Series switches.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax (EX Series Switches; for EX4600, see QFX Series Syntax) | 210
Description | 212
Options | 212
Syntax (EX Series Switches; for EX4600, see QFX Series Syntax)
<partition>
<root-partition>
Description
• On routers running Junos OS, back up the currently running and active file system partitions to
standby partitions that are not running. Specifically, the root file system (/) is backed up to /altroot,
and /config is backed up to /altconfig. The root and /config file systems are on the router's flash
drive, and the /altroot and /altconfig file systems are on the router's hard drive.
• On switches running Junos OS, take a snapshot of the files currently used to run the switch—the
complete contents of the root (/) , /altroot, /config, /var, and /var-tmp directories, which include the
running version of Junos OS, the active configuration, and log files.
Starting with Junos OS Release 15.1F3, the command request system snapshot creates a snapshot of the
guest OS image only for the PTX5000 with RE-DUO-C2600-16G, and the MX240, MX480, and MX960
routers with RE-S-1800X4-32G-S.
Starting with Junos OS Release 15.1F5, the command request system snapshot creates a snapshot of the
guest OS image only for the MX2010 and MX2020 routers with REMX2K-1800-32G-S.
On these routers, in order to create snapshot of the host OS image along with Junos OS image, use the
request vmhost snapshot command.
CAUTION: After you run the request system snapshot command, you cannot return to the
previous version of the software, because the running and backup copies of the
software are identical.
Options
• On the router, back up the currently running and active file system partitions to
standby partitions that are not running. Specifically, the root file system (/) is backed
up to /altroot, and /config is backed up to /altconfig. The root and /config file systems
are on the router's flash drive, and the /altroot and /altconfig file systems are on the
router's hard drive.
213
• On the switch, take a snapshot of the files currently used to run the switch and copy
them to the media that the switch did not boot from. If the switch is booted from
internal media, the snapshot is copied to external (USB) media. If the switch is booted
from external (USB) media, the snapshot is copied to internal media.
• If the snapshot destination is external media but a USB flash drive is not
connected, an error message is displayed.
• all-lcc—On a TX Matrix router, archive data and executable areas for all T640 routers
(or line-card chassis) connected to a TX Matrix router. On a TX Matrix Plus router,
archive data and executable areas for all routers (or line-card chassis) connected to a
TX Matrix Plus router.
• lcc number—On a TX Matrix router, archive data and executable areas for a specific
T640 router (or line-card chassis) that is connected to a TX Matrix router. On a TX
Matrix Plus router, archive data and executable areas for a specific router (line-card
chassis) that is connected to a TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
all-members | (EX Series Virtual Chassis, MX Series routers, QFX Series switches, QFabric System, and
local | member OCX1100 only) (Optional) Specify where to place the snapshot (archive data and
member-id
executable areas) in a Virtual Chassis:
214
• all-members—Create a snapshot (archive data and executable areas) for all members of
the Virtual Chassis.
• local—Create a snapshot (archive data and executable areas) on the member of the
Virtual Chassis that you are currently logged into.
• member member-id—Create a snapshot (archive data and executable areas) for the
specified member of the Virtual Chassis.
config- (EX Series Virtual Chassis, MX Series routers, QFX Series switches, QFabric System,
partition OCX1100, and T and TX Series routers only) Create a snapshot of the configuration
partition only and store it onto the default /altconfig on the hard disk device or an /
altconfig on a USB device. Option deprecated for Junos OS with Upgraded FreeBSD in
Junos OS Release 15.1.
To determine which platforms support Junos OS with upgraded FreeBSD, see Feature
Explorer and enter one of the following:
• For non-virtualized, enter freebsd and select Junos kernel upgrade to FreeBSD 10+.
• For virtualized, enter virtualization and select Virtualization of the Routing Engine.
media type (ACX Series, M320, T640, and MX Series routers) (Optional) Specify the boot device the
software is copied to:
• usb—(ACX Series, M320, T640, and, except for MX104, MX Series routers) Copy
software to the device connected to the USB port.
• usb0—(MX104 routers only) Copy software to the device connected to the USB0 port.
• usb1—(MX104 routers only) Copy software to the device connected to the USB1 port.
partition (Optional) Repartition the flash drive before a snapshot occurs. If the partition table on
the flash drive is corrupted, the request system snapshot command fails and reports errors.
The partition option is only supported for restoring the software image from the hard
drive to the flash drive.
215
(Routers only) You cannot issue the request system snapshot command when you enable
flash disk mirroring. We recommend that you disable flash disk mirroring when you
upgrade or downgrade the software.
(EX Series switches only) If the snapshot destination is the media that the switch did not
boot from, you must use the partition option.
re0 | re1 | (EX6200 and EX8200 switches only) Specify where to place the snapshot in a redundant
routing- Routing Engine configuration.
engine
routing- • re0—Create a snapshot on Routing Engine 0.
engine-id
• re1—Create a snapshot on Routing Engine 1.
root- (M, MX, T, and TX Series routers; EX Series Virtual Chassis; QFX Series switches; QFabric
partition System; and OCX1100 only) Create a snapshot of the root partition only and store it onto
the default /altroot on the hard disk device or an /altroot on a USB device. Option
deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.
To determine which platforms run Junos OS with Upgraded FreeBSD, see the information
in Release Information for Junos OS with Upgraded FreeBSD.
slice (EX Series switches, EX Series Virtual Chassis, QFX Series switches, QFabric System, and
alternate OCX1100 only) (Optional) Take a snapshot of the active root partition and copy it to the
alternate slice on the boot media.
Option deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1.
To determine which platforms support Junos OS with upgraded FreeBSD, see Feature
Explorer and enter one of the following:
• For non-virtualized, enter freebsd and select Junos kernel upgrade to FreeBSD 10+.
• For virtualized, enter virtualization and select Virtualization of the Routing Engine.
scc (TX Matrix router only) (Optional) Archive data and executable areas for a TX Matrix
router (or switch-card chassis).
sfc number (TX Matrix Plus router only) (Optional) Archive data and executable areas for a TX Matrix
Plus router (or switch-fabric chassis). Replace number with 0.
216
Additional Information
• (Routers only) Before you upgrade the software on the router, when you have a known stable system,
issue the request system snapshot command to back up the software, including the configuration, to
the /altroot and /altconfig file systems. After you have upgraded the software on the router and are
satisfied that the new packages are successfully installed and running, issue the request system snapshot
command again to back up the new software to the /altroot and /altconfig file systems.
• (Routers only) You cannot issue the request system snapshot command when you enable flash disk
mirroring. We recommend that you disable flash disk mirroring when you upgrade or downgrade the
software.
• (TX Matrix and TX Matrix Plus router only) On a routing matrix, if you issue the request system snapshot
command on the primary Routing Engine, all the primary Routing Engines connected to the routing
matrix are backed up. If you issue this command on the backup Routing Engine, all the backup
Routing Engines connected to the routing matrix are backed up.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
request system snapshot partition (EX4600, QFX Series, QFabric System, and OCX1100)
lcc2-re0:
--------------------------------------------------------------------------
Copying '/' to '/altroot' .. (this may take a few minutes)
Copying '/config' to '/altconfig' .. (this may take a few minutes)
The following filesystems were archived: / /config
fpc0:
--------------------------------------------------------------------------
219
fpc1:
--------------------------------------------------------------------------
Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes)
The following filesystems were archived: /
fpc2:
--------------------------------------------------------------------------
Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes)
The following filesystems were archived: /
fpc3:
--------------------------------------------------------------------------
Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes)
The following filesystems were archived: /
fpc4:
--------------------------------------------------------------------------
Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes)
The following filesystems were archived: /
fpc5:
--------------------------------------------------------------------------
Copying '/dev/da0s2a' to '/dev/da0s1a' .. (this may take a few minutes)
The following filesystems were archived: /
Release Information
Options <config-partition> and <root-partition> introduced in Junos OS Release 13.1 for M Series, MX
Series, T Series, and TX Series routers.
Option media usb-port-number introduced in Junos OS Release 13.2 for MX104 routers.
Options <config-partition>, <root-partition>, and <slice> deprecated for Junos OS with Upgraded FreeBSD
in Junos OS Release 15.1
To determine which platforms support Junos OS with upgraded FreeBSD, see Feature Explorer and
enter one of the following:
• For non-virtualized, enter freebsd and select Junos kernel upgrade to FreeBSD 10+.
220
• For virtualized, enter virtualization and select Virtualization of the Routing Engine.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 220
Description | 220
Options | 221
Syntax
Description
Terminate a unified in-service software upgrade (ISSU). The unified ISSU must be in progress and you
must issue this command from a router session other than the one on which you issued the request system
in-service-upgrade command that launched the unified ISSU.
221
Options
view
Output Fields
When you enter the request system software abort command on a new router session, you are provided
feedback on the status of your request in the router session on which you issued the request system
software in-service-upgrade command.
Sample Output
Rebooting re1
error: ISSU Aborted! Backup RE maybe in inconsistent state, Please restore backup RE
ISSU: IDLE
{master}
user@host>
223
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 224
Description | 227
Options | 228
Syntax
Description
We recommend that you always download the software image to /var/tmp only. On EX Series and QFX
Series switches, you must use the /var/tmp directory. Other directories are not supported.
When you are upgrading to a different release of Junos OS, you usually use the validate option on this
command. The validate option checks the candidate software against the current configuration of the
device to ensure they are compatible. (Validate is the default behavior when the software package being
added is a different release.) However, there are circumstances under which you cannot validate the
running configuration in this way. One such circumstance is when you are upgrading to Junos OS with
upgraded FreeBSD from Junos OS based on FreeBSD 6.1. Another such circumstance is when you are
updating between different releases of Junos OS with upgraded FreeBSD, and the newest version of
FreeBSD uses system calls that are not available in earlier versions of FreeBSD.
Therefore, you cannot use the validate option when upgrading to Junos Release 21.2R1, because this
release runs on FreeBSD 12; previous releases with upgraded FreeBSD run either FreeBSD 10 or 11.
If you are upgrading between releases that cannot use direct validation, you need to specify one of the
following on the request system software add operational mode command when you upgrade:
• The no-validate option—this option does not validate the software package against the current
configuration. Therefore, the current configuration might fail once you upgrade the system. Choose
this option for the first time you upgrade a system to the newer version.
• The validate-on-host option—this option validates the software package by comparing it to the running
configuration on a remote Junos OS host. Be sure to choose a host that you have already upgraded
to the newer version of software.
228
• The validate-on-routing-engine option—(for systems with redundant REs) this option validates the
software package by comparing it to the running configuration on a Routing Engine in the same
chassis. Use this option when you have already upgraded the other Routing Engine to the newer
version.
For information on valid filename and URL formats, see Format for Specifying Filenames and URLs in
Junos OS CLI Commands.
Any configuration changes performed after inputting the request system software add command will be lost
when the system reboots with an upgraded version of Junos OS.
Starting from Junos OS Release 17.2R1, PTX10008 routers do not support the request system software add
command. Starting from Junos OS Release 17.4R1, PTX10016 routers do not support the request system
software add command. Use the request vmhost software add command instead of the request system software
add command on the PTX10008 and PTX10016 routers to install or upgrade the Junos OS software
package or bundle on the router. See request vmhost software add.
When graceful Routing Engine switchover (GRES) is enabled on a device, you must perform a unified in-
service software upgrade (ISSU) operation to update the software running on the device. With GRES
enabled, if you attempt to perform a software upgrade by entering the request system software add package-
name command, an error message is displayed stating that only in-service software upgrades are
supported when GRES is configured. In such a case, you must either remove the GRES configuration
before you attempt the upgrade or perform a unified ISSU.
Starting with Junos OS Release 15.1F3, the statement request system software add installs a software
package for the guest OS only for the PTX5000 router with RE-DUO-C2600-16G, and for MX240,
MX480, and MX960 routers with RE-S-1800X4-32G-S.
Starting with Junos OS Release 15.1F5, the statement request system software add installs a software
package for the guest OS only for the MX2010 and MX2020 routers with REMX2K-1800-32G-S.
On these routers, in order to install both Junos software and host software packages, use the request
vmhost software add command.
Options
In Junos OS, package-name can be either the URL of a remote location or the
pathname of a local package. But Junos OS Evolved does not support a remote iso
for upgrade, so “URL” is removed from the help string in the CLI.
For example:
229
• The pathname in the protocol is the relative path to the user’s home directory
on the remote system and not the root directory.
• Do not use the scp protocol in the request system software add command to
download and install a software package or bundle from a remote location. The
previous statement does not apply to the QFabric switch. The software
upgrade is handled by the management process (mgd), which does not support
scp.
Use the file copy command to copy the software package or bundle from the
remote location to the /var/tmp directory on the hard disk:
file copy scp://source/package-name /var/tmp
Then install the software package or bundle using the request system software add
command:
request system software add /var/tmp/package-name
best-effort-load (Optional) Activate a partial load and treat parsing errors as warnings instead of
errors.
230
component all (QFabric systems only) (Optional) Install the software package on all of the QFabric
components.
delay-restart (Optional) Install a software package or bundle, but do not restart software
processes.
device-alias alias- (Junos Fusion only) (Optional) Install the satellite software package onto the
name specified satellite device using the satellite device’s alias name.
force (Optional) Force the addition of the software package or bundle (ignore warnings).
force-host (Optional) Force the addition of the host software package or bundle
(ignore warnings) on the QFX5100 device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) In a routing matrix
based on the TX Matrix router, install a software package or bundle on a T640
router that is connected to the TX Matrix router. In a routing matrix based on the
TX Matrix Plus router, install a software package or bundle on a router that is
connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
member member- (MX Series routers only) (Optional) Install a software package on the specified
id Virtual Chassis member. Replace member-id with a value of 0 or 1.
partition (QFX3500 switches only) (Optional) Format and repartition the media before
installation.
satellite slot-id (Junos Fusion only) (Optional) Install the satellite software package onto the
specified satellite device using the satellite devices FPC slot identifier.
scc (TX Matrix routers only) (Optional) Install a software package or bundle on a
Routing Engine on a TX Matrix router (or switch-card chassis).
231
sfc number (TX Matrix Plus routers only) (Optional) Install a software package or bundle on a
Routing Engine on a TX Matrix Plus router. Replace number with 0.
no-copy (Optional) Install a software package or bundle, but do not save copies of the
package or bundle files.
no-validate (Optional) When loading a software package or bundle with a different release,
suppress the default behavior of the validate option.
To upgrade to Junos OS Release 21.2R1, you cannot use the validate option.
Instead, choose one of the following options:
• no-validate
• validate-on-host
• validate-on-routing-engine
re0 | re1 (Optional) On routers or switches that support dual or redundant Routing Engines,
load a software package or bundle on the Routing Engine in slot 0 (re0) or the
Routing Engine in slot 1 (re1).
reboot (Optional) After adding the software package or bundle, reboot the system. On a
QFabric switch, the software installation is not complete until you reboot the
component for which you have installed the software.
set [package- (Mixed EX4200 and EX4500 Virtual Chassis, M Series, MX Series, and T Series
name1package- routers only) (Optional) Install multiple packages at same time:
name2]
• In the case of mixed EX4200 and EX4500 Virtual Chassis, install two software
packages—a package for an EX4200 switch and the same release of the
package for an EX4500 switch—to upgrade all member switches in a mixed
EX4200 and EX4500 Virtual Chassis.
• In the case of M Series, MX Series, and T Series routers, install multiple (two or
more) software packages and software add-on packages at the same time. The
variable package-name can either be a list of installation packages, each
separated by a blank space, or the full URL to the directory or tar file
containing the list of installation packages.
232
Use the request system software add set command to retain any SDK configuration by
installing the SDK add-on packages along with the core Junos OS installation
package.
unlink (Optional) On M Series, T Series, and MX Series routers, use the unlink option to
remove the software package from this directory after a successful upgrade is
completed.
upgrade-group [ all (Junos Fusion only) (Required to configure a Junos Fusion using autoconversion or
|upgrade-group- manual conversion) Associate a satellite software image with a satellite software
name]
upgrade group. The satellite software package is associated with the specified
satellite software upgrade group using the upgrade-group-name, or for all satellite
software upgrade groups in a Junos Fusion when the all keyword is specified.
validate (Optional) Validate the software package or bundle against the current
configuration as a prerequisite to adding the software package or bundle. This is
the default behavior when the software package or bundle being added is a
different release.
To upgrade to Junos OS Release 21.2R1, you cannot use the validate option.
Instead, choose one of the following options:
• no-validate
• validate-on-host
• validate-on-routing-engine
The validate option only works on systems that do not have graceful-switchover
(GRES) enabled. To use the validate option on a system with GRES, either disable
233
GRES for the duration of the installation, or install using the command request
system software in-service-upgrade , which requires nonstop active routing (NSR) to
be enabled when using GRES.
validate-on- (Optional) Validate the software bundle or package by comparing it to the running
routing-engine configuration on a Junos OS Routing Engine on the same chassis. Specify a
routing-engine
Routing Engine, replacing routing-engine with the routing engine name.
Additional Information
Before upgrading the software on the router or switch, when you have a known stable system, issue the
request system snapshot command to back up the software, including the configuration, to the /altroot
and /altconfig file systems. After you have upgraded the software on the router or switch and are
satisfied that the new package or bundle is successfully installed and running, issue the request system
snapshot command again to back up the new software to the /altroot and /altconfig file systems.
The request system snapshot command is currently not supported on the QFabric system. Also, you cannot
add or install multiple packages on a QFabric system.
After you run the request system snapshot command, you cannot return to the previous version of the
software because the running and backup copies of the software are identical.
If you are upgrading more than one package at the same time, delete the operating system package,
jkernel, last. Add the operating system package, jkernel, first and the routing software package, jroute,
last. If you are upgrading all packages at once, delete and add them in the following order:
By default, when you issue the request system software add package-name command on a TX Matrix primary
Routing Engine, all the T640 primary Routing Engines that are connected to it are upgraded to the same
version of software. If you issue the same command on the TX Matrix backup Routing Engine, all the
T640 backup Routing Engines that are connected to it are upgraded to the same version of software.
234
Likewise, when you issue the request system software add package-name command on a TX Matrix Plus
primary Routing Engine, all the T1600 or T4000 primary Routing Engines that are connected to it are
upgraded to the same version of software. If you issue the same command on the TX Matrix Plus backup
Routing Engine, all the T1600 or T4000 backup Routing Engines that are connected to it are upgraded
to the same version of software.
Before installing software on a device that has one or more custom YANG data models added to it, back
up and remove the configuration data corresponding to the custom YANG data models from the active
configuration. For more information see Managing YANG Packages and Configurations During a
Software Upgrade or Downgrade.
maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
WARNING: and log files, but this can not be guaranteed. This is the
WARNING: pre-installation stage and all the software is loaded when
WARNING: you reboot the system.
request system software add (Mixed EX4200 and EX4500 Virtual Chassis)
ECDSA256+SHA256 V
erified junos-srxsme-19.4R1.3-domestic signed by PackageProductionEc_2019 method ECDSA256+SHA256
JUNOS 19.4R1.3 will become active at next reboot
WARNING: A reboot is required to load this software correctly
WARNING: Use the 'request system reboot' command
WARNING: when software installation is complete Saving state for rollback ...
Release Information
sfc option introduced in Junos OS Release 9.6 for the TX Matrix Plus router.
set [package-name1package-name2] option added in Junos OS Release 11.1 for EX Series switches. Added in
Junos OS Release 12.2 for M Series, MX Series, and T Series routers.
On EX Series switches, the set [package-name1package-name2] option allows you to install only two software
packages on a mixed EX4200 and EX4500 Virtual Chassis. Whereas, on M Series, MX Series, and T
Series routers, the set [package-name1package-name2package-name3] option allows you to install multiple
software packages and software add-on packages at the same time.
upgrade-with-config and upgrade-with-config-format format options added in Junos OS Release 12.3 for M
Series routers, MX Series routers, and T Series routers, EX Series Ethernet switches, and QFX Series
devices.
device-alias, satellite, upgrade-group, and version options introduced in Junos OS Release 14.2R3 for Junos
Fusion.
validate-on-host and validate-on-routing-engine options added in Junos OS Release 15.1F3 for PTX5000
routers and MX240, MX480, and MX960 routers.
upgrade-with-config-format format option deleted in Junos OS Release 16.1 for M Series routers, MX Series
routers, and T Series routers, EX Series Ethernet switches, and QFX Series devices.
241
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 241
Description | 241
Options | 243
Syntax
Description
Use this command to remove all configuration information on the Routing Engines and reset all key
values on the device where you run the command.
242
• If the device has dual Routing Engines, the command is broadcast to all Routing Engines on the
device.
• In a Virtual Chassis or Virtual Chassis Fabric (VCF) composed of EX Series switches (except EX8200
Virtual Chassis) or QFX Series switches, this command operates only on the member switch where
you run the command, even if that switch is in the primary Routing Engine role. The command is not
forwarded to the backup Routing Engine member or to member switches in the line-card role. To
apply this command to more than one member of an EX Series or QFX Series Virtual Chassis or VCF,
we recommend you remove and disconnect each of those members from the Virtual Chassis or VCF,
and then run the command on each isolated switch individually.
This command removes all data files, including customized configuration and log files, by unlinking the
files from their directories. The command removes all user-created files from the system, including all
plain-text passwords, secrets, and private keys for SSH, local encryption, local authentication, IPsec,
RADIUS, TACACS+, and SNMP.
This command reboots the device and sets it to the factory default configuration. After the reboot, you
cannot access the device through the management Ethernet interface. Log in through the console as root
and start the Junos OS CLI by typing cli at the prompt.
If the configuration contains the commit synchronize statement at the [edit system] hierarchy level, and you
issue a commit in the primary Routing Engine, the primary configuration is automatically synchronized
with the backup. If the backup Routing Engine is down when you issue the commit, the Junos OS displays
a warning and commits the candidate configuration in the primary Routing Engine. When the backup
Routing Engine comes up, its configuration will automatically be synchronized with the primary. A newly
inserted backup Routing Engine or a Routing Engine that comes up after running the request system
zeroize command also automatically synchronizes its configuration with the primary Routing Engine
configuration.
Starting with Junos OS Release 15.1F3, the request system zeroize command removes all configuration
information on the guest OS for the PTX5000 router with RE-DUO-C2600-16G, and MX240, MX480,
and MX960 with RE-S-1800X4-32G-S.
Starting with Junos OS Release 15.1F5, the request system zeroize command removes all configuration
information on the guest OS for the MX2010 and MX2020 with REMX2K-1800-32G-S.
On these routers, in order to remove all configuration information on both guest OS and host OS, use
the request vmhost zeroize command.
To completely erase user-created data so that it is unrecoverable, use the media option.
243
Options
media (Optional) In addition to removing all configuration and log files, causes memory and the media
to be scrubbed, removing all traces of any user-created files. Every storage device attached to
the system is scrubbed, including disks, flash drives, removable USBs, and so on. The duration of
the scrubbing process is dependent on the size of the media being erased. As a result, the
request system zeroize media operation can take considerably more time than the request system
zeroize operation. However, the critical security parameters are all removed at the beginning of
the process.
On QFX Series platforms running Junos OS Release 14.1X53 or earlier, the media option is not
available. On QFX Series platforms running releases later than Junos OS Release 14.1X53 that
do not have the upgraded FreeBSD kernel (10+), the media option is available, but if you use it,
the system will issue a warning that the media option is not supported and will continue with the
zeroize operation. On platforms that are not QFX Series platforms, the media option is not
available in Junos OS Release 17.2 or later with Junos with upgraded FreeBSD.
local (Optional) Remove all the configuration information and restore all the key values on the active
Routing Engine.
Specifying this option has no effect on switches in a Virtual Chassis or VCF composed of EX
Series switches (except EX8200 Virtual Chassis) or QFX switches, because in these
configurations, the request system zeroize command only operates locally by default.
maintenance
Sample Output
0 1 1 0 0 0 done
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 246
Syntax (EX Series Devices, MX104, MX204, MX2010, MX2020, MX10003, MX10008, and MX2008
Universal Routing Platforms) | 246
Description | 247
Options | 248
Syntax
Description
Display a list of all Flexible PIC Concentrators (FPCs) and PICs installed in the router or switch chassis,
including the hardware version level and serial number.
• On EX2200 switches, EX3200 switches, EX4200 standalone switches, and EX4500 switches—Refers
to the switch; FPC number is always 0.
• On EX8208 and EX8216 switches—Refers to a line card; FPC number equals the slot number for the
line card.
On QFX3500, QFX5100, and OCX Series standalone switches, and PTX1000 devices both the FPC and
FPC number are always 0.
On T4000 Type 5 FPCs, there are no top temperature sensor or bottom temperature sensor parameters. Instead,
fan intake temperature sensor and fan exhaust temperature sensors parameters are displayed.
Starting from Junos OS Release 11.4, the output of the show chassis hardware models operational mode
command displays the enhanced midplanes FRU model numbers (CHAS-BP3-MX240-S, CHAS-BP3-
MX480-S or CHAS-BP3-MX960-S) based on the router. Prior to release 11.4, the FRU model numbers
are left blank when the router has enhanced midplanes. Note that the enhanced midplanes are
introduced through the Junos OS Release 13.3, but can be supported on all Junos OS releases.
Starting with Junos OS Release 14.1, the output of the show chassis hardware detail | extensive | clei-
models | models operational mode command displays the new DC power supply module (PSM) and power
distribution unit (PDU) that are added to provide power to the high-density FPC (FPC2-PTX-P1A) and
other components in a PTX5000 Packet Transport Router.
Options
none Display information about hardware. For a TX Matrix router, display information
about the TX Matrix router and its attached T640 devices. For a TX Matrix Plus
router, display information about the TX Matrix Plus router and its attached
devices.
clei-models (Optional) Display Common Language Equipment Identifier (CLEI) barcode and
model number for orderable field-replaceable units (FRUs).
all-members (MX Series devices only) (Optional) Display hardware-specific information for all
the members of the Virtual Chassis configuration.
interconnect- (QFabric systems only) (Optional) Display hardware-specific information for the
device name Interconnect device.
lcc number (TX Matrix devices and TX Matrix Plus router only) (Optional) On a TX Matrix
router, display hardware information for a specified T640 router (line-card chassis)
that is connected to the TX Matrix router. On a TX Matrix Plus router, display
hardware information for a specified router (line-card chassis) that is connected to
the TX Matrix Plus router.
249
Replace number with the following values depending on the LCC configuration:
local (MX Series devices only) (Optional) Display hardware-specific information for the
local Virtual Chassis members.
member member-id (MX Series devices and EX Series switches) (Optional) Display hardware-specific
information for the specified member of the Virtual Chassis configuration. Replace
member-id variable with a value 0 or 1.
models (Optional) Display model numbers and part numbers for orderable FRUs and, for
components that use ID EEPROM format v2, the CLEI code.
node-device name (QFabric systems only) (Optional) Display hardware-specific information for the
Node device.
satellite [slot-id (Junos Fusion only) (Optional) Display hardware information for the specified
slot-id | device-alias satellite device in a Junos Fusion, or for all satellite devices in the Junos Fusion if
alias-name]
no satellite devices are specified.
scc (TX Matrix router only) (Optional) Display hardware information for the TX Matrix
router (switch-card chassis).
sfc number (TX Matrix Plus router only) (Optional) Display hardware information for the
TX Matrix Plus router (switch-fabric chassis). Replace number variable with 0.
Additional Information
The show chassis hardware detail command now displays DIMM information for the following Routing
Engines, as shown in Table 5 on page 250.
250
In Junos OS Release 11.4 and later, the output for the show chassis hardware models operational mode
command for MX Series devices display the enhanced midplanes FRU model numbers—CHAS-BP3-
MX240-S, CHAS-BP3-MX480-S, or CHAS-BP3-MX960-S—based on the router. In releases before Junos
OS Release 11.4, the FRU model numbers are left blank when the router has enhanced midplanes. Note
that the enhanced midplanes are introduced through Junos OS Release 13.3, but can be supported on all
Junos OS releases.
Starting with Junos OS Release 17.3R1, the output of the show chassis hardware command displays the
mode in which vMX is running (performance mode or lite mode) in the part number field for the FPC.
RIOT-PERF indicates performance mode and RIOT-LITE indicates lite mode.
Starting with Junos OS Release 22.2R1, the RE-S-X6-128G-K Routing Engine (RE) is supported for
MX240, MX480, and MX960 devices. View the details of the RE in the command output.
view
Output Fields
Table 6 on page 250 lists the output fields for the show chassis hardware command. Output fields are listed
in the approximate order in which they appear.
Serial number Serial number of the chassis component. The serial number of the All levels
backplane is also the serial number of the router chassis. Use this serial
number when you need to contact Juniper Networks Customer Support
about the router or switch chassis.
Assb ID or (extensive keyword only) Identification number that describes the FRU extensive
Assembly ID hardware.
Assembly Version (extensive keyword only) Version number of the FRU hardware. extensive
FRU model number (clei-models, extensive, and models keyword only) Model number of the none specified
FRU hardware component.
CLEI code (clei-models and extensive keyword only) Common Language Equipment none specified
Identifier code. This value is displayed only for hardware components
that use ID EEPROM format v2. This value is not displayed for
components that use ID EEPROM format v1.
EEPROM Version ID EEPROM version used by the hardware component: 0x00 (version 0), extensive
0x01 (version 1), or 0x02 (version 2).
252
• Type of PIC. If the PIC type is not supported on the current software
release, the output states Hardware Not Supported.
• Type of FPC: FPC Type 1, FPC Type 2, FPC Type 3, FPC Type 4 , or FPC
TypeOC192.
The following list shows the PIM abbreviation in the output and the
corresponding PIM name.
• 2x T1—Dual-port T1 PIM
• 2x E1—Dual-port E1 PIM
• 1x ADSL Annex A—ADSL 2/2+ Annex A PIM (one port, for POTS)
253
• 1x ADSL Annex B—ADSL 2/2+ Annex B PIM (one port, for ISDN)
Sample Output
Hardware inventory:
Item Version Part number Serial number Description
Chassis JN1230686AFB MX480
Midplane REV 05 710-017414 ACRB7717 MX480 Midplane
FPM Board REV 02 710-017254 CADF2017 Front Panel Display
PEM 0 Rev 03 740-022697 QCS1142C0HJ PS 1.2-1.7kW; 100-240V AC in
PEM 1 Rev 01 740-022697 QCS1035C0CM PS 1.2-1.7kW; 100-240V AC in
Routing Engine 0 REV 06 711-145342 CASE0160 RE-S-X6-128G-K
CB 0 REV 05 750-055976 CAES7891 Enhanced MX SCB 2
CB 1 REV 12 750-062572 CALM3310 Enhanced MX SCB 2
Fan Tray Enhanced Left Fan Tray
Hardware inventory:
Item Version Part number Serial number Description
Chassis DE538 JNP10008 [MX10008]
Midplane REV 27 750-054097 ACPD6954 Midplane 8
Routing Engine 0 BUILTIN BUILTIN RE X10
Routing Engine 1 BUILTIN BUILTIN RE X10 128
CB 0 REV 10 750-079562 CAKF2158 Control Board
CB 1 REV 05 711-065897 CAJG2680 Control Board
FPC 1 REV 04 750-084779 CAKN5706 JNP10K-LC2101
CPU REV 05 750-073391 CAKJ2864 LC 2101 PMB
PIC 0 BUILTIN BUILTIN 4xQSFP28 SYNCE
Xcvr 0 REV 01 740-046565 XXL0BQM QSFP+-40G-SR4
Xcvr 1 REV 01 740-032986 QB350242 QSFP+-40G-SR4
Xcvr 2 REV 01 740-054053 QE408285 QSFP+-4X10G-SR
Xcvr 3 REV 01 740-046565 QF3300Z9 QSFP+-40G-SR4
PIC 1 BUILTIN BUILTIN 4xQSFP28 SYNCE
Xcvr 0 REV 01 740-067442 QJ2200LD QSFP+-40G-SR4
Xcvr 1 REV 01 740-038153 APF170500382DP QSFP+-40G-CU3M
Xcvr 2 REV 01 740-067442 QI4302LC QSFP+-40G-SR4
PIC 2 BUILTIN BUILTIN 4xQSFP28 SYNCE
Xcvr 0 REV 01 740-067442 1ACP1335119 QSFP+-40G-SR4
Xcvr 1 REV 01 740-067442 1ACP1313156 QSFP+-40G-SR4
Xcvr 2 REV 01 740-067442 QK050040 QSFP+-40G-SR4
Xcvr 3 REV 01 740-067442 QJ2201BG QSFP+-40G-SR4
PIC 3 BUILTIN BUILTIN 4xQSFP28 SYNCE
Xcvr 0 REV 01 740-058734 1ECQ12400CS QSFP-100GBASE-SR4
Xcvr 1 REV 01 740-046565 QF3300ZX QSFP+-40G-SR4
Xcvr 2 REV 01 740-061405 1ECQ12510FH QSFP-100G-SR4-T2
Xcvr 3 REV 01 740-032986 QB491182 QSFP+-40G-SR4
PIC 4 BUILTIN BUILTIN 4xQSFP28 SYNCE
Xcvr 0 REV 01 740-067442 QJ2200D5 QSFP+-40G-SR4
Xcvr 1 REV 01 740-054053 XXS0L95 QSFP+-4X10G-SR
PIC 5 BUILTIN BUILTIN 4xQSFP28 SYNCE
Xcvr 0 REV 01 740-054053 QE251550 QSFP+-4X10G-SR
Xcvr 1 REV 01 740-054053 XZB01D5 QSFP+-4X10G-SR
Xcvr 3 REV 01 740-046565 QI1402F9 QSFP+-40G-SR4
FPD Board REV 07 711-054687 ACPF2896 Front Panel Display
PEM 1 REV 02 740-049388 1EDL62102PR Power Supply AC
PEM 2 REV 02 740-049388 1EDL60300H2 Power Supply AC
PEM 4 REV 02 740-049388 1EDL603003Z Power Supply AC
PEM 5 REV 01 740-049388 1EDL339001B Power Supply AC
FTC 0 REV 14 750-050108 ACNW3344 Fan Controller 8
FTC 1 REV 14 750-050108 ACPE3978 Fan Controller 8
256
PSM 1 Rev 03 740-069994 1F269170144 JNP10K 5500W AC/HVDC Power Supply Unit
PSM 2 REV 02 740-049388 1EDL60300C6 JNP10K 5500W AC/HVDC Power Supply Unit
PSM 3 REV 02 740-049388 1EDL603005X JNP10K 5500W AC/HVDC Power Supply Unit
PSM 4 REV 02 740-049388 1EDL6170275 JNP10K 5500W AC/HVDC Power Supply Unit
PSM 5 REV 02 740-049388 1EDL61701WD JNP10K 5500W AC/HVDC Power Supply Unit
Routing Engine 0 BUILTIN BUILTIN JNP10K-RE1-E
CB 0 REV 15 750-079562 BCAW3941 Control Board
Routing Engine 1 BUILTIN BUILTIN JNP10K-RE1-E
CB 1 REV 15 750-079562 BCAW3942 Control Board
FPC 0 REV 07 750-093524 BCAY8271 JNP10K-LC1201
CPU REV 14 710-001726 HM1084 FPC CPU
FPC 10 REV 07 750-093524 BCAY8277 JNP10K-LC1201CPU REV 05
710-010169 HZ3219 FPC CPU-Enhanced
SIB 0 REV 02 750-083426 BCAV7680 SIB-JNP10016
SIB 1 REV 02 750-083426 BCAV7682 SIB-JNP10016
SIB 2 REV 02 750-083426 BCAV7681 SIB-JNP10016
SIB 3 REV 02 750-083426 BCAV7684 SIB-JNP10016
SIB 4 REV 02 750-083426 BCAV7683 SIB-JNP10016
SIB 5 REV 02 750-083426 BCAV7685 SIB-JNP10016
FTC 0 REV 10 750-086270 BCAV0609 Fan Controller 16
Fan Tray 0 REV 02 750-103311 BCAY1793 Fan Tray 16
Fan Tray 1 REV 02 750-103311 BCAY1797 Fan Tray 16
Address 0x40: ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff
FPM GBUS REV 02 710-002901 HE3245
...
FPM Display REV 02 710-002897 HA4873
...
CIP REV 05 710-002895 HA4729
...
PEM 1 RevX02 740-002595 MD21815 Power Entry Module
...
SCG 0 REV 04 710-003423 HF6023
...
SCG 1 REV 04 710-003423 HF6061
...
Routing Engine 0 REV 01 740-005022 210865700292 RE-3.0
...
CB 0 REV 06 710-002728 HE3614
...
FPC 1 REV 01 710-002385 HE3009 FPC Type 1
... REV 06 710-001726 HC0010
The show chassis hardware command output does not include information about the fan tray serial number
and part number of MX204 routers. This does not affect the fan's functionality.
Hardware inventory:
Item Version Part number Serial number Description
Chassis JN1080B50AFA MX960
Midplane REV 02 710-013698 CC6226 MX960 Backplane
Fan Extender REV 02 710-018051 JY5235 Extended Cable Manager
FPM Board REV 01 710-014974 JS4207 Front Panel Display
270
Airflow - AFO
Fan Tray 2 JNP10001 Fan Tray, Front to Back
Airflow - AFO
Fan Tray 3 JNP10001 Fan Tray, Front to Back
Airflow - AFO
Fan Tray 4 JNP10001 Fan Tray, Front to Back
Airflow - AFO
Fan Tray 5 JNP10001 Fan Tray, Front to Back
Airflow - AFO
Release Information
sfc option introduced in Junos OS Release 9.6 for the TX Matrix Plus router.
Information for disk and usb introduced in Junos OS Release 15.1X53-D60 for QFX10002, QFX10008,
and QFX10016 switches.
NOTE: Devices and routing platforms use the basic syntax, unless otherwise listed. For example,
the EX Series has an additional satellite parameter available.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 273
Description | 273
Options | 274
Syntax
Description
Display the current status of the flight recorder tool and associated parameters, such as the running
status of the tool, and the current data snapshot list.
274
Options
view
Output Fields
Table 7 on page 274 lists the output fields for the show flight-recorder status command. Output fields are
listed in the approximate order in which they appear.
• Not Running—The flight recorder tool is not enabled. By default, the flight
recorder tool is disabled.
Recent Parameter Data Information about configured parameters for the flight recorder tool:
Flags set Information about additional flags configured for the flight recorder tool:
Snapshot Directory Log file that is recorded and saved in the flight recorder directory.
The recorded snapshots and core log files are saved in a folder under
the /var/log/flight_recorder/ directory. The folder format is
Flr_MONTH_DD_YYYY_HH:MM:SS; for example, Flr_May_09_2018_02:20:50.
List of snapshots List of log files recorded and saved under the flight recorder directory.
Sample Output
Flags set:
Collect-core flag is set
Logical System flag is Not set (default)
List of snapshots:
flr_2018-02-22_13:26:41.txt
276
flr_2018-02-22_13:27:04.txt
flr_2018-02-22_13:27:28.txt
Release Information
RELATED DOCUMENTATION
show host
IN THIS SECTION
Syntax | 276
Syntax | 277
Description | 277
Options | 277
Syntax
Syntax
Description
Options
Additional Information
The show host command displays the raw data received from the name server.
view
Sample Output
show host
Address: 192.0.2.0
Aliases:
Release Information
show log
IN THIS SECTION
Syntax | 278
Description | 279
Options | 279
Syntax
show log
<filename | user <username>>
279
show log
<all-lcc | lcc number | scc>
<filename | user <username>>
Description
List log files, display log file contents, or display information about users who have logged in to the
router or switch.
Options
<all-lcc | lcc (Routing matrix only)(Optional) Display logging information about all T640 routers (or
number | scc> line-card chassis) or a specific T640 router (replace number with a value from 0
through 3) connected to a TX Matrix router. Or, display logging information about
the TX Matrix router (or switch-card chassis).
device-type (QFabric system only) (Optional) Display log messages for only one of the following
device types:
280
NOTE: If you specify the device-type optional parameter, you must also specify
either the device-id or device-alias optional parameter.
(device-id | If a device type is specified, display logs for a device of that type. Specify either the
device-alias) device ID or the device alias (if configured).
filename (Optional) Display the log messages in the specified log file. For the routing matrix,
the filename must include the chassis information.
NOTE: The filename parameter is mandatory for the QFabric system. If you
did not configure a syslog filename, specify the default filename of messages.
user (Optional) Display logging information about users who have recently logged in to
<username> the router or switch. If you include username, display logging information about the
specified user.
trace
Sample Output
show log
Release Information
Option device-type (device-id | device-alias) is introduced in Junos OS Release 13.1 for the QFX Series.
285
RELATED DOCUMENTATION
syslog (System)
IN THIS SECTION
Syntax | 285
Description | 287
Options | 287
Syntax
Description
Display information about the active IP sockets on the Routing Engine. Use this command to verify
which servers are active on a system and what connections are currently in progress.
Options
none Display information about all active IP sockets on the Routing Engine.
extensive (Optional) Display exhaustive system process information, which, for TCP
connections, includes the TCP control block and MSS. This option is useful for
debugging TCP connections.
288
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Display system
connection activity for all the routers in the chassis.
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display system connection activity for all T640 routers connected to the TX
Matrix router. On a TX Matrix Plus router, display system connection activity for
all connected T1600 or T4000 LCCs
all-members (EX4200 switches and MX Series routers only) (Optional) Display system
connection activity for all members of the Virtual Chassis configuration.
infrastructure (QFabric systems only) (Optional) Display system connection activity for the fabric
name control Routing Engines or fabric manager Routing Engines.
interconnect- (QFabric systems only) (Optional) Display system connection activity for the
device name Interconnect device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display system connection activity for a specific T640 router that is
connected to the TX Matrix router. On a TX Matrix Plus router, display system
connection activity for a specific router that is connected to the TX Matrix Plus
router.
Replace number with the following values depending on the LCC configuration:
local (EX4200 switches and MX Series routers only) (Optional) Display system
connection activity for the local Virtual Chassis member.
member member- (EX4200 switches and MX Series routers only) (Optional) Display system
id connection activity for the specified member of the Virtual Chassis configuration.
289
For EX4200 switches, replace member-id with a value from 0 through 9. For an MX
Series Virtual Chassis, replace member-id with a value of 0 or 1.
node node-name (Junos OS Evolved only) (Optional) Display system connection activity for the
specified node.
node-group name (QFabric systems only) (Optional) Display system connection activity for the Node
group.
scc (TX Matrix routers only) (Optional) Display system connection activity for the
TX Matrix router (or switch-card chassis).
sfc (TX Matrix routers only) (Optional) Display system connection activity for the
TX Matrix Plus router.
Additional Information
By default, when you issue the show system connections command on the primary Routing Engine of a TX
Matrix router or a TX Matrix Plus router, the command is broadcast to all the primary Routing Engines of
the LCCs connected to it in the routing matrix. Likewise, if you issue the same command on the backup
Routing Engine of a TX Matrix or a TX Matrix Plus router, the command is broadcast to all backup
Routing Engines of the LCCs that are connected to it in the routing matrix.
NOTE: The device calculates the TCP MSS value as described in RFC 6691.
view
Output Fields
Table 8 on page 290 describes the output fields for the show system connections command. Output fields
are listed in the approximate order in which they appear.
290
Proto Protocol of the socket: IP, TCP, or UDP for IPv4 or IPv6.
Recv-Q Number of input bytes received by the protocol and waiting to be processed
by the application.
Send-Q Number of output bytes sent by the application and waiting to be processed
by the protocol.
Local Address Local address and port of the socket, separated by a period. An asterisk (*)
indicates that the bound address is the wildcard address. Server sockets
typically have the wildcard address and a well-known port bound to them.
Foreign Address Foreign address and port of the socket, separated by a period. An asterisk (*)
indicates that the address or port is a wildcard.
Routing Instance (Displayed only when the show-routing-instance option is used.) Routing
instances associated with active IP sockets on the Routing Engine.
Sample Output
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 295
Description | 295
Options | 295
Syntax
Description
Options
view
Output Fields
Table 9 on page 295 lists the output fields for the show system name-resolution command. Output fields are
listed in the approximate order in which they appear.
Last update Date and time when the hostname-to-IP address mapping were last resolved.
Refresh interval Interval for refreshing the cache with the updated hostname-to-IP address mappings.
Last change Timestamp for the last change in the hostname-to-IP address mappings.
command-name
Release Information
IN THIS SECTION
Syntax | 297
Description | 298
Options | 299
Syntax
show version
<brief | detail>
show version
<all-members>
<brief | detail>
<local>
<member member-id>
show version
<brief | detail>
<all-members>
298
<local>
<member member-id>
show version
<brief | detail>
<component component-name | all>
show version
<brief | detail>
<node node-id | local | primary>
Description
Display the hostname and version information about the software running on the router or switch.
Beginning in Junos OS Release 13.3, the show version command output includes the Junos field that
displays the Junos OS version, including any selective upgrade (JSU) packages, running on the device.
This field provides a consistent means of identifying the Junos OS version, rather than extracting that
information from the list of installed sub-packages.
junos-install-* Junos OS based on an upgraded FreeBSD kernel instead of older versions of FreeBSD
Options
none Display standard information about the hostname and version of the software
running on the router or switch.
all-members (EX4200 switches and MX Series routers only) (Optional) Display standard
information about the hostname and version of the software running on all
members of the Virtual Chassis configuration.
component all (QFabric systems only) (Optional) Display the host name and version information
about the software running on all the components on the QFabric system.
component (QFabric systems only) (Optional) Display the host name and version information
component-name about the software running on a specific QFabric system component. Replace
component-name with the name of the QFabric system component. The
component-name can be the name of a diagnostics Routing Engine, Director group,
fabric control Routing Engine, fabric manager Routing Engine, Interconnect device,
or Node group.
local (EX4200 switches and MX Series routers only) (Optional) Display standard
information about the hostname and version of the software running on the local
Virtual Chassis member.
member (EX4200 switches and MX Series routers only) (Optional) Display standard
member-id information about the hostname and version of the software running on the
specified member of the Virtual Chassis configuration. For EX4200 switches,
replace member-id with a value from 0 through 9. For an MX Series Virtual Chassis,
replace member-id with a value of 0 or 1.
node (all | node- (Optional) Display version information for the specified node or all nodes.
name)
primary (SRX Series only) Display the software version on the primary node.
view
Release Information
start shell
IN THIS SECTION
Syntax | 300
Description | 300
Options | 301
Syntax
Description
Exit from the CLI environment and create a UNIX-level shell. To return to the CLI, type exit from the
shell.
Juniper Networks does not provide support for operations in the shell.
NOTE:
• To issue this command, the user must have the required login access privileges configured by
including the permissions statement at the [edit system login class class-name] hierarchy level.
• UNIX wheel group membership or permissions are no longer required to issue this command.
301
Options
Additional Information
When you are in the shell, the shell prompt has the following format:
username@hostname%
root@host%
shell or maintenance
Output Fields
When you enter this command, you are provided feedback on the status of your request.
Sample Output
exit
%
exit
user@host>
Release Information
CHAPTER 10
IN THIS CHAPTER
show fib-local-accounting ip
IN THIS SECTION
Syntax | 304
Description | 304
Syntax
show fib-local-accounting ip
Description
Display the number of packets that were sent to an anchor MPC due to FIB localization.
view
Sample Output
show fib-local-accounting ip
Release Information
RELATED DOCUMENTATION
fib-remote | 102
fib-local | 101
Example: Configuring Packet Forwarding Engine FIB Localization | 30
IN THIS SECTION
Syntax | 305
Description | 306
Options | 306
Syntax
Description
Options
none Display the last 50 commit operations on the static configuration database,
starting with the most recent.
revision (Optional) Display the revision number of the active configuration of the Routing
Engine(s).
NOTE: By default, the status of the commit server is “Not running”. The
commit server starts running only when a commit job is added to the batch.
synchronize-server (Optional) Display the pending commit synchronize operations for all instances of
pending-jobs the ephemeral configuration database on an MX Series Virtual Chassis or a device
with dual Routing Engines. This option can only be executed on the primary
Routing Engine of the Virtual Chassis primary router or the dual Routing Engine
system.
view
Output Fields
Table 11 on page 307 describes the output fields for the show system commit command. Output fields are
listed in the approximate order in which they appear.
307
<number> Displays the last 50 commit operations listed, most recent to first. The identifier none
<number> designates a configuration created for recovery using the request system
configuration rescue save command.
• other—When there is no login name associated with the session, the values
for user and client default to root and other. For example, during a reboot
after package installation, mgd commits the configuration as a system commit,
and there is no login associated with the commit.
<rollback Identifies whether commit confirmed is issued. It is removed once commit or commit none
pending> check is issued or commit confirmed is rolled back after rollback timeout.
308
Sample Output
Release Information
Option server introduced in Junos OS Release 12.1 for the PTX Series router.
Option synchronize-server introduced in Junos OS Release 17.2R1 and Junos OS Evolved Release 22.1R1.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 310
Description | 310
Options | 310
Syntax
Description
Options
maintenance
Output Fields
Table 12 on page 311 describes the output fields for the show system configuration database usage command.
Output fields are listed in the approximate order in which they appear.
311
Maximum size of the database Display the maximum available space on the disk to store the configuration
database
Current database size on disk Display the total space on the disk used by the current configuration database
Actual database usage Display the actual space on the disk used by the current configuration data
Available database space Display the free space available on the disk to store the configuration database
Sample Output
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 312
Description | 312
Options | 312
Syntax
Description
Display high-level system information for the device including the model number, device family, Junos
OS release, and hostname.
Options
view
313
Sample Output
Release Information
IN THIS SECTION
Syntax | 314
Description | 315
Options | 316
Syntax
Description
Display information about software processes that are running on the router or switch and that have
controlling terminals.
316
Options
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Display standard
system process information about all the T640 routers (in a routing matrix based
on the TX Matrix router) or all the T1600 or T4000 routers (in a routing matrix
based on the TX Matrix Plus router) in the chassis.
all-lcc (TX Matrix routers and TX Matrix Plus router only) (Optional) Display standard
system process information for all T640 routers (or line-card chassis) connected
to the TX Matrix router. Display standard system process information for all
connected T1600 or T4000 LCCs.
all-members (EX4200 switches, QFX Series Virtual Chassis, and MX Series routers )
(Optional) Display standard system process information for all members of the
Virtual Chassis configuration.
ancpd-service Display the Access Node Control Protocol (ANCP) process, which works with a
special Internet Group Management Protocol (IGMP) session to collect outgoing
interface mapping events in a scalable manner.
application- Display the process that identifies an application using intrusion detection and
identification prevention (IDP) to allow or deny traffic based on applications running on
standard or nonstandard ports.
bootp Display the process that enables a router, switch, or interface to act as a
Dynamic Host Configuration Protocol (DHCP) or bootstrap protocol (BOOTP)
relay agent. DHCP relaying is disabled.
317
captive-portal- Display the HTTP redirect service by specifying the location to which a
content-delivery subscriber's initial Web browser session is redirected, enabling initial
provisioning and service selection for the subscriber.
ce-l2tp-service (Optional) (M10, M10i, M7i, and MX Series routers only) Display the Universal
Edge Layer 2 Tunneling Protocol (L2TP) process, which establishes L2TP tunnels
and Point-to-Point Protocol (PPP) sessions through L2TP tunnels.
class-of-service (Optional) Display the class-of-service (CoS) process, which controls the router's
or switch’s CoS configuration.
clksyncd-service Display the external clock synchronization process, which uses synchronous
Ethernet (SyncE).
craft-control Display the process for the I/O of the craft interface.
database-replication (EX Series switches and MX Series routers only) (Optional) Display the database
replication process.
disk-monitoring (Optional) Display the disk monitoring process, which checks the health of the
hard disk drive on the Routing Engine.
dynamic-flow- (Optional) Display the dynamic flow capture (DFC) process, which controls DFC
capture configurations on Monitoring Services III PICs.
ecc-error-logging (Optional) Display the error checking and correction (ECC) process, which logs
ECC parity errors in memory on the Routing Engine.
318
ethernet- Display the process that provides IEEE 802.1ag OAM connectivity fault
connectivity-fault- management (CFM) database information for CFM maintenance association end
management
points (MEPs) in a CFM session.
ethernet-link-fault- (EX Series switches and MX Series routers only) (Optional) Display the process
management that provides the OAM link fault management (LFM) information for Ethernet
interfaces.
firewall (Optional) Display the firewall management process, which manages the firewall
configuration and enables accepting or rejecting packets that are transiting an
interface on a router or switch.
general- (EX Series switches and MX Series routers only) (Optional) Display the general
authentication- authentication process.
service
health (pid process- (Optional) Display process health information, either by process id (PID) or by
identifer | process- process name.
name process-name)
host-processes Display process information of processes running on the host system.
idp-policy Display the intrusion detection and prevention (IDP) protocol process.
ilmi Display the Integrated Local Management Interface (ILMI) protocol process,
which provides bidirectional exchange of management information between
two ATM interfaces across a physical connection.
interface-control (Optional) Display the interface process, which controls the router's or switch’s
physical interface devices and logical interfaces.
kernel-replication (Optional) Display the kernel replication process, which replicates the state of
the backup Routing Engine when graceful Routing Engine switchover (GRES) is
configured.
319
l2-learning (Optional) Display the Layer 2 address flooding and learning process.
l2cpd-service Display the Layer 2 Control Protocol process, which enables features such as
Layer 2 protocol tunneling and nonstop bridging.
lacp (Optional) Display the Link Aggregation Control Protocol (LACP)process. LACP
provides a standardized means for exchanging information between partner
systems on a link to allow their link aggregation control instances to reach
agreement on the identity of the LAG to which the link belongs, and then to
move the link to that LAG, and to enable the transmission and reception
processes for the link to function in an orderly manner.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display standard system process information for a specific T640 router
that is connected to the TX Matrix router. On a TX Matrix Plus router, display
standard system process information for a specific router that is connected to
the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
local (EX4200 switches, QFX Series Virtual Chassis, and MX Series routers) (Optional)
Display standard system process information for the local Virtual Chassis
member.
local-policy-decision- Display the process for the Local Policy Decision Function, which regulates
function collection of statistics related to applications and application groups and
tracking of information about dynamic subscribers and static interfaces.
logical-system-mux Display the logical router multiplexer process (lrmuxd), which manages the
multiple instances of the routing protocols process (rpd) on a machine running
logical routers.
320
mac-validation Display the MAC validation process, which configures MAC address validation
for subscriber interfaces created on demux interfaces in dynamic profiles on MX
Series routers.
member member-id (EX4200 switches, QFX Series Virtual Chassis, and MX Series routers) (Optional)
Display standard system process information for the specified member of the
Virtual Chassis configuration. For EX4200 switches, replace member-id with a
value from 0 through 9. For an MX Series Virtual Chassis, replace member-id with
a value of 0 or 1.
mib-process (Optional) Display the MIB II process, which provides the router's MIB II agent.
mobile-ip (Optional) Display the Mobile IP process, which configures Junos OS Mobile IP
features.
mountd-service (EX Series switches and MX Series routers only) (Optional) Display the service
for NFS mounts requests.
multicast-snooping (EX Series switches and MX Series routers only) (Optional) Display the multicast
snooping process, which makes Layer 2 devices such as VLAN switches aware
of Layer 3 information, such as the media access control (MAC) addresses of
members of a multicast group.
named-service (Optional) Display the DNS Server process, which is used by a router or a switch
to resolve hostnames into addresses.
neighbor-liveness Display the process, which specifies the maximum length of time that the router
waits for its neighbor to re-establish an LDP session.
nfsd-service (Optional) Display the Remote NFS Server process, which provides remote file
access for applications that need NFS-based transport.
ntp Display the Network Time Protocol (NTP) process, which provides the
mechanisms to synchronize time and coordinate time distribution in a large,
diverse network.
packet-triggered- Display the packet-triggered subcribers and policy control (PTSP) process, which
subscribers allows the application of policies to dynamic subscribers that are controlled by a
subscriber termination device.
321
pgcp-service (Optional) Display the pgcpd service process running on the Routing Engine.
pgm Display the Pragmatic General Multicast (PGM) protocol process, which enables
a reliable transport layer for multicast applications.
pic-services-logging (Optional) Display the logging process for some PICs. With this process, also
known as fsad (the file system access daemon), PICs send special logging
information to the Routing Engine for archiving on the hard disk.
ppp (Optional) Display the Point-to-Point Protocol (PPP) process, which is the
encapsulation protocol process for transporting IP traffic across point-to-point
links.
ppp-service Display the Universal edge PPP process, which is the encapsulation protocol
process for transporting IP traffic across universal edge routers.
pppoe (Optional) Display the Point-to-Point Protocol over Ethernet (PPPoE) process,
which combines PPP that typically runs over broadband connections with the
Ethernet link-layer protocol that allows users to connect to a network of hosts
over a bridge or access concentrator.
sampling (Optional) Display the sampling process, which performs packet sampling based
on particular input interfaces and various fields in the packet header.
sbc-configuration- Display the session border controller (SBC) process of the border signaling
process gateway (BSG).
scc (TX Matrix routers only) (Optional) Display standard system process information
for the TX Matrix router (or switch-card chassis).
sdk-service Display the SDK Service process, which runs on the Routing Engine and is
responsible for communications between the SDK application and Junos OS.
Although the SDK Service process is present on the router, it is turned off by
default.
secure-neighbor- (EX Series switches and MX Series routers only) (Optional) Display the secure
discovery Neighbor Discovery Protocol (NDP) process, which provides support for
protecting NDP messages.
send (Optional) Display the Secure Neighbor Discovery Protocol (SEND) process,
which provides support for protecting Neighbor Discovery Protocol (NDP)
messages.
service-deployment (Optional) Display the service deployment process, which enables Junos OS to
work with the Session and Resource Control (SRC) software.
sfc number (TX Matrix Plus routers only) (Optional) Display system process information for
the TX Matrix Plus router. Replace number with 0.
snmp Display the SNMP process, which enables the monitoring of network devices
from a central location and provides the router's or switch’s SNMP primary
agent.
sonet-aps Display the SONET Automatic Protection Switching (APS) process, which
monitors any SONET interface that participates in APS.
static-subscribers (Optional) Display the Static subscribers process, which associates subscribers
with statically configured interfaces and provides dynamic service activation and
activation for these subscribers.
tunnel-oamd (Optional) Display the Tunnel OAM process, which enables the Operations,
Administration, and Maintenance of Layer 2 tunneled networks. Layer 2
protocol tunneling (L2PT) allows service providers to send Layer 2 protocol data
units (PDUs) across the provider’s cloud and deliver them to Juniper Networks
EX Series Ethernet Switches that are not part of the local broadcast domain.
323
vrrp (EX Series switches and MX Series routers only) (Optional) Display the Virtual
Router Redundancy Protocol (VRRP) process, which enables hosts on a LAN to
make use of redundant routing platforms on that LAN without requiring more
than the static configuration of a single default route on the hosts.
watchdog Display the watchdog timer process, which enables the watchdog timer when
Junos OS encounters a problem.
wide (Optional) Display process information that might be wider than 80 columns.
node node-name Specify a name if you want to view the system process details for that node.
Example: re0.
Additional Information
By default, when you issue the show system processes command on the primary Routing Engine of a TX
Matrix router or a TX Matrix Plus router, the command is broadcast to all the primary Routing Engines of
the LCCs connected to it in the routing matrix. Likewise, if you issue the same command on the backup
Routing Engine of a TX Matrix or a TX Matrix Plus router, the command is broadcast to all backup
Routing Engines of the LCCs that are connected to it in the routing matrix.
view
Output Fields
The following table describes the output fields for the show system processes command. Output fields are
listed in the approximate order in which they appear.
last pid Last process identifier assigned to the process. brief extensive
summary
load averages Three load averages followed by the current time. brief extensive
summary
324
processes Number of existing processes and the number of processes in each brief extensive
state (sleeping, running, starting, zombies, and stopped). summary
CPU (For systems running Junos OS with upgraded FreeBSD only) extensive
Breakdown of the percent usage on a per-CPU basis into the following
categories: % user, % nice, % system, % interrupt, % idle.
Mem Information about physical and virtual memory allocation. brief extensive
summary
325
Active Memory allocated and actively used by the program. brief extensive
summary
When the system is under memory pressure, the pageout process
reuses memory from the free, cache, inact and, if necessary, active
pages. When the pageout process runs, it scans memory to see which
pages are good candidates to be unmapped and freed up. Thus, the
distinction between Active and Inact memory is only used by the
pageout process to determine which pool of pages to free first at the
time of a memory shortage.
The pageout process first scans the Inact list, and checks whether the
pages on this list have been accessed since the time they have been
listed here. The pages that have been accessed are moved from the
Inact list to the Active list. On the other hand, pages that have not been
accessed become prime candidates to be freed by the pageout process.
If the pageout process cannot produce enough free pages from the
Inact list, pages from the Active list get freed up.
Because the pageout process runs only when the system is under
memory pressure, the pages on the Inact list remain untouched – even
if they have not been accessed recently – when the amount of Free
memory is adequate.
Inact Memory allocated but not recently used or memory freed by the brief extensive
programs. Inactive memory remains mapped in the address space of one summary
or more processes and, therefore, counts toward the RSS value of those
processes.
Any amount of memory freed by the routing protocol process might still
be considered part of the RES value. Generally, the kernel delays the
migrating of memory out of the Inact queue into the Cache or Free list
unless there is a memory shortage.
Wired Memory that is not eligible to be swapped, usually used for in-kernel brief extensive
memory structures and/or memory physically locked by a process. summary
Cache Memory that is not associated with any program and does not need to brief extensive
be swapped before being reused. summary
326
Buf Size of memory buffer used to hold data recently called from the disk. brief extensive
summary
Free Memory that is not associated with any programs. Memory freed by a brief extensive
process can become Inactive, Cache, or Free, depending on the method summary
used by the process to free the memory.
Swap Information about physical and virtual memory allocation. brief extensive
summary
NOTE: Memory can remain swapped out indefinitely if it is not accessed
again. Therefore, the show system process extensive command shows
that memory is swapped to disk even though there is plenty of free
memory, and such a situation is not unusual.
STAT Symbolic process state. The state is given by a sequence of letters. The none detail
first letter indicates the run state of the process:
• R—Runnable
• T—Stopped
• Z—Dead (zombie)
PRI Current priority of the process. A lower number indicates a higher detail extensive
priority. summary
NI or NICE UNIX "niceness" value. A lower number indicates a higher priority. detail extensive
summary
SIZE Total size of the process (text, data, and stack), in kilobytes. extensive summary
This is also known as RSS or Resident Set Size. The RES value includes
shared library pages used by the process. Any amount of memory freed
by the process might still be considered part of the RES value. Generally,
the kernel delays the migrating of memory out of the Inact queue into
the Cache or Free list unless there is a memory shortage. This can lead to
large discrepancies between the values reported by the routing protocol
process and the kernel, even after the routing protocol process has
freed a large amount of memory.
329
STATE Current state of the process (for example, sleep, wait, run, idle, zombie, or extensive summary
stop).
TIME (S) Number of system and user CPU seconds that the detail extensive
process has used. summary
(None, D, and E) Total amount of time that the command has been
running.
Sample Output
3 ?? DL 0:00.00 (vmdaemon)
4 ?? DL 0:42.37 (update)
5 ?? DL 0:00.00 (if_jnx)
80 ?? Ss 0:14.66 syslogd -s
96 ?? Is 0:00.01 portmap
128 ?? Is 0:02.70 cron
173 ?? Is 0:02.24 /usr/local/sbin/sshd (sshd1)
189 ?? S 0:03.80 /sbin/watchdog -t180
190 ?? I 0:00.03 /usr/sbin/tnetd -N
191 ?? S 2:24.76 /sbin/ifd -N
192 ?? S< 0:55.44 /usr/sbin/xntpd -N
195 ?? S 0:53.11 /usr/sbin/snmpd -N
196 ?? S 1:15.73 /usr/sbin/mib2d -N
198 ?? I 0:00.75 /usr/sbin/inetd -N
2677 ?? I 0:00.01 /usr/sbin/mgd -N
2712 ?? Ss 0:00.24 rlogind
2735 ?? R 0:00.00 /bin/ps -ax
1985 p0- S 0:07.41 ./rpd -N
2713 p0 Is 0:00.24 -tcsh (tcsh)
2726 p0 S+ 0:00.07 cli
Mem: 25M Active, 3976K Inact, 19M Wired, 8346K Buf, 202M Free
Swap: 528M Total, 64K Used, 528M Free
PID USERNAME THR PRI NICE SIZE RES STATE TIME WCPU COMMAND
11 root 1 171 52 0K 12K RUN 807.5H 98.73% idle
13 root 1 -20 -139 0K 12K WAIT 36:17 0.00% swi7: clock sio
1499 root 1 96 0 7212K 3040K select 34:01 0.00% license-check
1621 root 1 96 0 20968K 11216K select 20:25 0.00% mib2d
1465 root 2 8 -88 115M 11748K nanslp 14:32 0.00% chassisd
1478 root 1 96 0 6336K 3816K select 11:28 0.00% ppmd
20 root 1 -68 -187 0K 12K WAIT 10:28 0.00% irq10: em0 em1+++*
1490 root 1 96 0 11792K 4336K select 9:44 0.00% shm-rtsdbd
1618 root 1 96 0 39584K 7464K select 8:47 0.00% pfed
1622 root 1 96 0 15268K 10988K select 6:16 0.00% snmpd
1466 root 1 96 0 7408K 2896K select 5:44 0.00% alarmd
7 root 1 -16 0 0K 12K client 5:09 0.00% ifstate notify
1480 root 1 96 0 5388K 2660K select 4:29 0.00% ksyncd
12 root 1 -40 -159 0K 12K WAIT 4:15 0.00% swi2: netisr 0
332
Release Information
Option sfc introduced for the TX Matrix Plus router in Junos OS Release 9.6.
Enhanced output regarding per CPU usage introduced in Junos OS Release 16.1R3 for Junos OS with
upgraded FreeBSD.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 333
Description | 333
Options | 334
333
Syntax
Description
Options
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router,
display system queue statistics for all the T640 routers in the chassis that are connected
to the TX Matrix router. On a TX Matrix Plus router, display system queue statistics for
all the T1600 or T4000 routers in the chassis that are connected the TX Matrix Plus
router.
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) Display system queue
statistics for all LCC chassis attached to the TX Matrix or TX Matrix Plus router.
all-members (MX Series routers only) (Optional) Display system queue statistics for all members of
the Virtual Chassis configuration.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router,
display system queue statistics for a specific T640 router that is connected to the TX
Matrix router. On a TX Matrix Plus router, display system queue statistics for a specific
connected router that is connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D
SIBs in a routing matrix.
local (MX Series routers only) (Optional) Display system queue statistics for the local Virtual
Chassis member.
member (MX Series routers only) (Optional) Display system queue statistics for the specified
member-id member of the Virtual Chassis configuration. Replace member-id with a value of 0 or 1.
scc (TX Matrix routers only) (Optional) Display queue statistics for the TX Matrix router.
sfc number (TX Matrix Plus routers only) (Optional) Display system queue statistics for the TX Matrix
Plus router. Replace number with 0.
335
Additional Information
By default, when you issue the show system queues command on the primary Routing Engine of a TX Matrix
router or a TX Matrix Plus router, the command is broadcast to all the primary Routing Engines of the
LCCs connected to it in the routing matrix. Likewise, if you issue the same command on the backup
Routing Engine of a TX Matrix or a TX Matrix Plus router, the command is broadcast to all backup
Routing Engines of the LCCs that are connected to it in the routing matrix.
maintenance
Output Fields
Table 14 on page 336 lists the output fields for the show system queues command. Output fields are listed in
the approximate order in which they appear.
336
• ipip, lsi, tap, mt, mtun, pimd, and pime—Internally generated interface and not
configurable.
• dsc—Discard interface.
• gre—Internally generated interface that is configurable only as the control channel for
Generalized MPLS (GMPLS).
• ppd and ppe—Interfaces used to enable a cluster to act as a rendezvous point (RP) or
first hop router in the multicast domain.
Sample Output
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 338
Description | 339
Options | 339
Syntax
Description
Options
For Junos OS Evolved, the show system reboot command is applicable to all nodes
(Routing Engines and FPCs). There is no system reboot command for a specific
340
Routing Engine. Hence, the show system reboot command shows the pending reboot for
the system and not for a specific Routing Engine.
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display halt or reboot request information for all the T640 routers in the
chassis that are connected to the TX Matrix router. On a TX Matrix router, display
halt or reboot request information for all the T1600 or T4000 routers in the chassis
that are connected to the TX Matrix Plus router.
all-members (EX4200 switches and MX Series routers only) (Optional) Display halt or reboot
request information for all members of the Virtual Chassis configuration.
all-lcc (TX Matrix routers and TX Matrix Plus router only) (Optional) On a TX Matrix router,
display system halt or reboot request information for all T640 routers connected to
the TX Matrix router. On a TX Matrix Plus router, display halt or reboot request
information for all connected T1600 or T4000 LCCs.
both-routing- (Systems with multiple Routing Engines) (Optional) Display halt or reboot request
engines information on both Routing Engines.
infrastructure (QFabric systems only) (Optional) Display reboot request information on the fabric
name manager Routing Engines and fabric control Routing Engines.
interconnect- (QFabric systems only) (Optional) Display reboot request information on the
device name Interconnect device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display halt or reboot request information for a specific T640 router that is
connected to the TX Matrix router. On a TX Matrix Plus router, display halt or reboot
request information for a specific router that is connected to the TX Matrix Plus
router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
local (EX4200 switches and MX Series routers only) (Optional) Display halt or reboot
request information for the local Virtual Chassis member.
member (EX4200 switches and MX Series routers only) (Optional) Display halt or reboot
member-id request information for the specified member of the Virtual Chassis configuration.
For EX4200 switches, replace member-id with a value from 0 through 9. For an MX
Series Virtual Chassis, replace member-id with a value of 0 or 1.
node-group (QFabric systems only) (Optional) Display reboot request information on the Node
name group.
scc (TX Matrix router only) (Optional) Display halt or reboot request information for the
TX Matrix router (or switch-card chassis).
sfc (TX Matrix Plus router only) (Optional) Display halt or reboot request information for
the TX Matrix Plus router.
Additional Information
By default, when you issue the show system reboot command on a TX Matrix or TX Matrix Plus primary
Routing Engine, the command is broadcast to all the T640 (in a routing matrix based on the TX Matrix
router) or T1600 (in a routing matrix based on the TX Matrix Plus router) primary Routing Engines
connected to it. Likewise, if you issue the same command on the TX Matrix or TX Matrix Plus backup
Routing Engine, the command is broadcast to all the T640 (in a routing matrix based on the TX Matrix
router) or T1600 (in a routing matrix based on the TX Matrix Plus router) backup Routing Engines that
are connected to it.
For Junos OS Evolved, the show system reboot command is applicable to all nodes (Routing Engines and
FPCs). There is no system reboot command for a specific Routing Engine. Hence, the show system reboot
command shows the pending reboot for the system and not for a specific Routing Engine.
maintenance
342
Sample Output
lcc2-re0:
--------------------------------------------------------------------------
No shutdown/reboot scheduled.
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
343
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 343
Description | 343
Options | 344
Syntax
Description
• On the routers, this command display information about the backup software, which is located in
the /altroot, and /altconfig file systems or on the alternate media.
344
• On the switches, this command display information about the backup of the root file system (/) and
directories /altroot,/config, /var, and /var/tmp, which are located either on an external USB flash
drive or in internal flash memory.
Options
all-members | (EX Series switch Virtual Chassis only) (Optional) Display the snapshot in a Virtual
local | member Chassis:
member-id
• all-members—Display the snapshot for all members of the Virtual Chassis.
• local—Display the snapshot on the member of the Virtual Chassis that you are
currently logged into.
• member member-id—Display the snapshot for the specified member of the Virtual
Chassis.
media (external (EX Series switch only) (Optional) Display the destination media location for the
| internal) snapshot. The external option specifies the snapshot on an external mass storage
device, such as a USB flash drive. The internal option specifies the snapshot on an
internal memory source, such as internal flash memory. If no additional options are
specified, the command displays the snapshot stored in both slices.
view
Output Fields
Table 15 on page 344 lists the output fields for the show system snapshot command. Output fields are listed
in the approximate order in which they appear.
Sample Output
jcrypto-ex: 12.2I20120305_2240_user
jdocs-ex: 12.2I20120305_2240_user
jroute-ex: 12.2I20120305_2240_user
jswitch-ex: 12.2I20120305_2240_user
jweb-ex: 12.2I20120305_2240_user
Release Information
Option slice deprecated for Junos OS with Upgraded FreeBSD in Junos OS Release 15.1. You can find
which platforms run Junos OS with Upgraded FreeBSD here: Release Information for Junos OS with
Upgraded FreeBSD.
347
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 347
Description | 348
Options | 349
Syntax
<local>
<member member-id>
Description
Options
add-restart (Junos OS Evolved only) (Optional) Display all console messages from the last in-
service software upgrade (ISSU).
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Display system
software information for all the T640 routers (TX Matrix Router) or all the routers
(TX Matrix Plus Router) in the chassis.
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display system software information for all T640 routers connected to the
TX Matrix router. On a TX Matrix Plus router, display system software information
for all connected T1600 or T4000 LCCs.
all-members (EX4200 switches only) (Optional) Display the system software running on all
members of the Virtual Chassis configuration.
infrastructure (QFabric systems only) (Optional) Display the system software running on the fabric
name control Routing Engine and the fabric manager Routing Engine.
interconnect- (QFabric systems only) (Optional) Display the system software running on the
device name Interconnect device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display system software information for a specific T640 router that is
connected to the TX Matrix router. On a TX Matrix Plus router, display system
software information for a specific router that is connected to the TX Matrix Plus
router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
350
local (EX4200 switches only) (Optional) Display the system software running on the local
Virtual Chassis member.
member member- (EX4200 switches only) (Optional) Display the system software running on the
id specified member of the Virtual Chassis configuration. Replace member-id with a
value from 0 through 9.
node-group name (QFabric systems only) (Optional) Display the system software running on the Node
group.
scc (Routing matrix only) (Optional) Display the system software running on a
TX Matrix router (or switch-card chassis).
sfc (TX Matrix Plus routers only) (Optional) Display system software information for
the TX Matrix Plus router.
maintenance
Output Fields
When you enter this command, you are provided a list of Junos OS packages installed on the router and
their corresponding Junos OS release number.
Sample Output
Comment:
JUNOS Base OS Software Suite [7.2R1.7]
Comment:
JUNOS Crypto Software Suite [7.2R1.7]
Information for jdocs:
Comment:
JUNOS Online Documentation [7.2R1.7]
Comment:
JUNOS Kernel Software Suite [7.2R1.7]
Comment:
JUNOS Packet Forwarding Engine Support (M20/M40) [7.2R1.7]
Comment:
JUNOS Routing Software Suite [7.2R1.7]
Comment:
JUNOS Base OS boot [7.2R1.7]
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 352
Description | 353
Options | 353
Syntax
Description
Options
all-chassis (TX Matrix and TX Matrix Plus routers only) (Optional) Display system statistics for a
protocol for all the routers in the chassis.
all-lcc (TX Matrix and TX Matrix Plus routers only) (Optional) On a TX Matrix router, display
system statistics for a protocol for all T640 routers (or line-card chassis) connected to the
TX Matrix router. On a TX Matrix Plus router, display system statistics for a protocol for all
routers (line-card chassis) connected to the TX Matrix Plus router
all- (EX4200 switches and MX Series routers only) (Optional) Display system statistics for a
members protocol for all members of the Virtual Chassis configuration.
lcc number (TX Matrix and TX Matrix Plus routers only) (Optional) On a TX Matrix router, display
system statistics for a protocol for a specific T640 router that is connected to the TX
Matrix router. On a TX Matrix Plus router, display system statistics for a protocol for a
specific router that is connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 3, when T1600 routers are connected to a TX Matrix Plus router in a routing
matrix.
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D
SIBs in a routing matrix.
local (EX4200 switches and MX Series routers only) (Optional) Display system statistics for a
protocol for the local Virtual Chassis member.
member (EX4200 switches and MX Series routers only) (Optional) Display system statistics for a
member-id protocol for the specified member of the Virtual Chassis configuration. For EX4200
switches, replace member-id with a value from 0 through 9. For an MX Series Virtual
Chassis, replace member-id with a value of 0 or 1.
scc (TX Matrix routers only) (Optional) Display system statistics for a protocol for the TX
Matrix router (or switch-card chassis).
sfc number (TX Matrix Plus routers only) (Optional) Display system statistics for a protocol for the
TX Matrix Plus router (or switch-fabric chassis). Replace number with 0.
356
Additional Information
By default, when you issue the show system statistics command on a TX Matrix or TX Matrix Plus primary
Routing Engine, the command is broadcast to all the T640 (in a routing matrix based on the TX Matrix
router) or T1600 (in a routing matrix based on the TX Matrix Plus router) primary Routing Engines
connected to it. Likewise, if you issue the same command on the TX Matrix or TX Matrix Plus backup
Routing Engine, the command is broadcast to all the T640 (in a routing matrix based on the TX Matrix
router) or T1600 (in a routing matrix based on the TX Matrix Plus router) backup Routing Engines that
are connected to it.
view
Sample Output
0 cache overflow
0 reset
0 stale
0 aborted
0 badack
0 unreach
0 zone failures
0 cookies sent
0 cookies received
0 ACKs sent in response to in-window but not exact RSTs
0 ACKs sent in response to in-window SYNs on established connections
0 rcv packets dropped by TCP due to bad address
0 out-of-sequence segment drops due to insufficient memory
1058 RST packets
0 ICMP packets ignored by TCP
0 send packets dropped by TCP due to auth errors
0 rcv packets dropped by TCP due to auth errors
udp:
3658884 datagrams received
0 with incomplete header
0 with bad data length field
0 with bad checksum
3657342 dropped due to no socket
3657342 broadcast/multicast datagrams dropped due to no socket
0 dropped due to full socket buffers
0 not for hashed pcb
4291311496 delivered
1551 datagrams output
ipsec:
0 inbound packets processed successfully
0 inbound packets violated process security policy
0 inbound packets with no SA available
0 invalid inbound packets
0 inbound packets failed due to insufficient memory
0 inbound packets failed getting SPI
0 inbound packets failed on AH replay check
0 inbound packets failed on ESP replay check
0 inbound AH packets considered authentic
0 inbound AH packets failed on authentication
0 inbound ESP packets considered authentic
0 inbound ESP packets failed on authentication
0 outbound packets processed successfully
0 outbound packets violated process security policy
360
0 no route
0 administratively prohibited
0 beyond scope
0 address unreachable
0 port unreachable
0 packet too big
0 time exceed transit
0 time exceed reassembly
0 erroneous header field
0 unrecognized next header
0 unrecognized option
0 redirect
0 unknown
0 message responses generated
0 messages with too many ND options
ipsec6:
0 inbound packets processed successfully
0 inbound packets violated process security policy
0 inbound packets with no SA available
0 invalid inbound packets
0 inbound packets failed due to insufficient memory
0 inbound packets failed getting SPI
0 inbound packets failed on AH replay check
0 inbound packets failed on ESP replay check
0 inbound AH packets considered authentic
0 inbound AH packets failed on authentication
0 inbound ESP packets considered authentic
0 inbound ESP packets failed on authentication
0 outbound packets processed successfully
0 outbound packets violated process security policy
0 outbound packets with no SA available
0 invalid outbound packets
0 outbound packets failed due to insufficient memory
0 outbound packets with no route
clnl:
0 total packets received
0 packets delivered
0 too small
0 bad header length
0 bad checksum
0 bad version
0 unknown or unsupported protocol
0 bogus sdl size
363
Release Information
sfc option introduced for the TX Matrix Plus router in JUNOS Release 9.6.
IN THIS SECTION
Syntax | 372
Syntax | 373
Syntax (TX Matrix Plus Router and TX Matrix Plus Router with 3D SIBs) | 374
Description | 374
Options | 374
Syntax
Syntax
For more information, see show system storage partitions (View SRX Series).
Syntax (TX Matrix Plus Router and TX Matrix Plus Router with 3D SIBs)
Description
Display statistics about the amount of free disk space in the router's or switch’s file systems.
Options
none Display standard information about the amount of free disk space in the router's or
switch’s file systems.
invoke-on all- (Optional) Display the system storage information on all primary and backup
routing-engines Routing Engines on a routing matrix based on the TX Matrix or TX Matrix Plus
router or on a router that has dual Routing Engines.
invoke-on other- (Optional) Display the system storage information on the other Routing Engine. For
routing-engines example, if you issue this command on the primary Routing Engine on an M320
router, the JUNOS Software displays the system storage information on the backup
Routing Engine. On a routing matrix based on the TX Matrix or TX Matrix Plus
router, if you issue this command on the TX Matrix or TX Matrix Plus router’s
primary Routing Engine, the JUNOS Software displays all the system storage
information on all the backup Routing Engines.
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Display system
storage statistics for all the routers in the chassis.
375
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display system storage statistics for all T640 routers connected to the TX
Matrix router. On a TX Matrix Plus router, display system storage statistics for all
routers connected to the TX Matrix Plus router.
all-members (EX4200 switches and MX Series routers only) (Optional) Display system storage
statistics for all members of the Virtual Chassis configuration.
infrastructure (QFabric systems only) (Optional) Display system storage statistics for the fabric
name control Routing Engines or fabric manager Routing Engines.
interconnect- (QFabric systems only) (Optional) Display system storage statistics for the
device name Interconnect device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display system storage statistics for a specific T640 router that is connected
to the TX Matrix router. On a TX Matrix Plus router, display system storage
statistics for a specific router that is connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
local (EX4200 switches and MX Series routers only) (Optional) Display system storage
statistics for the local Virtual Chassis member.
member member- (EX4200 switches and MX Series routers only) (Optional) Display system storage
id statistics for the specified member of the Virtual Chassis configuration. For EX4200
switches, replace member-id with a value from 0 through 9. For an MX Series Virtual
Chassis, replace member-id with a value of 0 or 1.
node (Junos OS Evolved only) (Optional) Display system storage statistics for the
specified node.
376
node-group name (QFabric systems only) (Optional) Display system storage statistics for the Node
group.
scc (TX Matrix routers only) (Optional) Display system storage statistics for the TX
Matrix router (or switch-card chassis).
sfc number (TX Matrix Plus routers only) (Optional) Display system storage statistics for the TX
Matrix Plus router. Replace number with 0.
Additional Information
By default, when you issue the show system storage command on the primary Routing Engine of a TX
Matrix router or a TX Matrix Plus router, the command is broadcast to all the primary Routing Engines of
the LCCs connected to it in the routing matrix. Likewise, if you issue the same command on the backup
Routing Engine of a TX Matrix or a TX Matrix Plus router, the command is broadcast to all backup
Routing Engines of the LCCs that are connected to it in the routing matrix.
view
Output Fields
Table 16 on page 376 describes the output fields for the show system storage command. Output fields are
listed in the approximate order in which they appear.
Size Size of the filesystem. Size is reported in human readable standard output
form (GB or MB, etc.).
NOTE: In detailed output, the output is in bytes, whereas in regular output, the size is in human-readable form (like GB
or MB, etc.).
Sample Output
x86-64-16.2I20170508115447_evo-builder/python-3.3
/dev/loop7 191M 191M 0 100% /pivot/data/junos-install-qfx-
x86-64-16.2I20170508115447_evo-builder/dev
/dev/loop8 3.8M 3.8M 0 100% /pivot/data/junos-install-qfx-
x86-64-16.2I20170508115447_evo-builder/jimbase
/dev/loop9 103M 103M 0 100% /pivot/data/junos-install-qfx-
x86-64-16.2I20170508115447_evo-builder/osbase
/dev/loop10 44M 44M 0 100% /pivot/data/junos-install-qfx-
x86-64-16.2I20170508115447_evo-builder/initrd
unionfs 5.2G 2.4G 2.7G 48% /
/tmp 7.8G 4.0K 7.8G 1% /tmp
run 7.8G 7.1M 7.8G 1% /run
tmpfs 7.8G 1.2G 6.7G 15% /dev/shm
tmpfs 7.8G 0 7.8G 0% /sys/fs/cgroup
tmpfs 1.6G 0 1.6G 0% /run/user/0
Release Information
sfc option introduced for the TX Matrix Plus router in JUNOS Release 9.6.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 381
Description | 382
Options | 382
Syntax
Description
Display whether graceful Routing Engine switchover is configured, the state of the kernel replication
(ready or synchronizing), any replication errors, and whether the primary and standby Routing Engines
are using compatible versions of the kernel database.
NOTE: Issue the show system switchover command only on the backup Routing Engine. This
command is not supported on the primary Routing Engine because the kernel-replication process
daemon does not run on the primary Routing Engine. This process runs only on the backup
Routing Engine.
Beginning Junos OS Release 9.6, the show system switchover command has been deprecated on the primary
Routing Engine on all routers other than a TX Matrix (switch-card chassis) or a TX Matrix Plus (switch-
fabric chassis) router.
However, in a routing matrix, if you issue the show system switchover command on the primary Routing
Engine of the TX Matrix router (or switch-card chassis), the CLI displays graceful switchover information
for the primary Routing Engine of the T640 routers (or line-card chassis) in the routing matrix. Likewise,
if you issue the show system switchover command on the primary Routing Engine of a TX Matrix Plus router
(or switch-fabric chassis), the CLI displays output for the primary Routing Engine of T1600 or T4000
routers in the routing matrix.
Options
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router,
display graceful Routing Engine switchover information for all Routing Engines on the TX
Matrix router and the T640 routers configured in the routing matrix. On a TX Matrix Plus
router, display graceful Routing Engine switchover information for all Routing Engines on
the TX Matrix Plus router and the T1600 or T4000 routers configured in the routing
matrix.
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router,
display graceful Routing Engine switchover information for all T640 routers (or line-card
chassis) connected to the TX Matrix router. On a TX Matrix Plus router, display graceful
Routing Engine switchover information for all connected T1600 or T4000 LCCs.
Note that in this instance, packets get dropped. The LCCs perform GRES on their own
chassis (GRES cannot be handled by one particular chassis for the entire router) and
synchronization is not possible as the LCC plane bringup time varies for each LCC.
Therefore, when there is traffic on these planes, there may be a traffic drop.
383
all- (MX Series routers only) (Optional) Display graceful Routing Engine switchover
members information for all Routing Engines on all members of the Virtual Chassis configuration.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix router,
display graceful Routing Engine switchover information for a specific T640 router
connected to the TX Matrix router. On a TX Matrix Plus router, display graceful Routing
Engine switchover information for a specific router connected to the TX Matrix Plus
router.
Replace number with the following values depending on the LCC configuration:
• 0 through 3, when T1600 routers are connected to a TX Matrix Plus router in a routing
matrix.
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with 3D
SIBs in a routing matrix.
local (MX Series routers only) (Optional) Display graceful Routing Engines switchover
information for all Routing Engines on the local Virtual Chassis member.
member (MX Series routers only) (Optional) Display graceful Routing Engine switchover
member-id information for all Routing Engines on the specified member of the Virtual Chassis
configuration. Replace member-id with a value of 0 or 1.
scc (TX Matrix router only) (Optional) Display graceful Routing Engine switchover information
for the TX Matrix router (or switch-card chassis).
sfc (TX Matrix Plus routers only) (Optional) Display graceful Routing Engine switchover
information for the TX Matrix Plus router.
Additional Information
If you issue the show system switchover command on a TX Matrix backup Routing Engine, the command is
broadcast to all the T640 backup Routing Engines that are connected to it.
Likewise, if you issue the show system switchover command on a TX Matrix Plus backup Routing Engine, the
command is broadcast to all the T1600 or T4000 backup Routing Engines that are connected to it.
384
If you issue the show system switchover command on the active Routing Engine in the primary router of an
MX Series Virtual Chassis, the router displays a message that this command is not applicable on this
member of the Virtual Chassis.
view
Output Fields
Table 17 on page 384 describes the output fields for the show system switchover command. Output fields
are listed in the approximate order in which they appear.
• Ready—Kernel database has synchronized. This message implies that the system is ready
for GRES.
• Replication error—An error occurred when the state was replicated from the primary
Routing Engine. Inspect Steady State for possible causes, or notify Juniper Networks
customer support.
This field is displayed only when ksyncd is running in multichassis mode (LCC primary).
FEB1:
• Ready—Message for FEB1- PFE0, or FEB1- PFE1 being switchover ready. The backup
PFE is ready for switchover (does not include time for routes or nexthops for a scaled
configuration).
Sample Output
Switchover Status: Ready is the way the last line of the output reads if you are running Junos OS Release
16.1R1 or later. If you are running Junos OS Release 15.x, the last line of the output reads as Switchover
Ready, for example:
Switchover Status: Not Ready is the way the last line of the output reads if you are running Junos OS
Release 16.1R1 or later. If you are running Junos OS Release 15.x, the last line of the output reads as
Not ready for primary role switch, try after xxx secs, for example:
show system switchover all-lcc (Routing Matrix and Routing Matrix Plus)
lcc0-re0:
--------------------------------------------------------------------------
Multichassis replication: On
Configuration database: Ready
Kernel database: Ready
Peer state: Steady State
Switchover Status: Ready
lcc2-re0:
--------------------------------------------------------------------------
Multichassis replication: On
Configuration database: Ready
Kernel database: Ready
388
lcc2-re0:
-
Multichassis replication: On
Configuration database: Ready
Kernel database: Ready
Peer state: Steady State
Switchover Status: Ready</output>
</sample>
The switchover status option for ACX7509 is only available on backup Routing Engine. The show
outputs displayed system switchover status is "Ready" and "Not Ready" are as follows:
{backup}
user@host> show system switchover
Graceful switchover: On
Configuration database: Ready
Object database: Ready
Applications' ready state: Ready
Switchover Status: Not Ready
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
Command support added for ACX7509 in 22.1R1 for High Availability Platform Redundancy RCB and
FEB switchover.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 390
Description | 392
Options | 392
Syntax
Description
Display the current time and information about how long the router or switch, router or switch software,
and routing protocols have been running.
NOTE: Time values computed from differences in timestamps can vary due to the insertion or
deletion of leap-seconds between them.
The show system uptime command is a little different in how it displays output in Junos OS Evolved. The
show system uptime command by itself shows system-wide uptime information. Use the show system uptime
node node-name command to see node-specific uptime information, where node-name can be re0 | re1 | fpc0 |
all.
Options
none Show time since the system rebooted and processes started.
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Show time since the
system rebooted and processes started on all the routers in the chassis.
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, show time since the system rebooted and processes started for all T640
routers (or line-card chassis) connected to the TX Matrix router. On a TX Matrix Plus
router, show time since the system rebooted and processes started for all connected
T1600 or T4000 LCCs.
all-members (EX4200 switches and MX Series routers only) (Optional) Show time since the
system rebooted and processes started on all members of the Virtual Chassis
configuration.
director-group (QFabric systems only) (Optional) Show time since the system rebooted and
name processes started on the Director group.
infrastructure (QFabric systems only) (Optional) Show time since the system rebooted and
name processes started on the fabric control Routing Engine and fabric manager Routing
Engine.
interconnect- (QFabric systems only) (Optional) Show time since the system rebooted and
device name processes started on the Interconnect device.
393
invoke-on (MX Series routers only) (Optional) Display the time since the system rebooted and
processes started on the primary Routing Engine, backup Routing Engine, or both,
on a router with two Routing Engines.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, show time since the system rebooted and processes started for a specific
T640 router that is connected to the TX Matrix router. On a TX Matrix Plus router,
show time since the system rebooted and processes started for a specific router that
is connected to the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
local (EX4200 switches and MX Series routers only) (Optional) Show time since the
system rebooted and processes started on the local Virtual Chassis member.
member (EX4200 switches and MX Series routers only) (Optional) Show time since the
member-id system rebooted and processes started on the specified member of the Virtual
Chassis configuration. For EX4200 switches, replace member-id with a value from 0
through 9. For an MX Series Virtual Chassis, replace member-id with a value of 0 or 1.
node node-name (Junos OS Evolved only) (Optional) Display uptime information for the specified
node. When node option is not used, display uptime information for entire system.
From the system’s point of view, the system booted time is the time when the
system was assembled and is available in /var/run/system_boot_time.
node-group (QFabric systems only) (Optional) Show time since the system rebooted and
name processes started on the Node group.
scc (TX Matrix routers only) (Optional) Show time since the system rebooted and
processes started for the TX Matrix router (or switch-card chassis).
sfc number (TX Matrix Plus routers only) (Optional) Show time since the system rebooted and
processes started for the TX Matrix Plus router. Replace number with 0.
394
Additional Information
By default, when you issue the show system uptime command on the primary Routing Engine of a TX Matrix
router or a TX Matrix Plus router, the command is broadcast to all the primary Routing Engines of the
LCCs connected to it in the routing matrix. Likewise, if you issue the same command on the backup
Routing Engine of a TX Matrix or a TX Matrix Plus router, the command is broadcast to all backup
Routing Engines of the LCCs that are connected to it in the routing matrix.
view
Output Fields
Table 18 on page 394 describes the output fields for the show system uptime command. Output fields are
listed in the approximate order in which they appear.
System booted (Only for Junos OS Evolved when node option is not used) Time system was last booted.
From the system’s point of view, the system booted time is the time when the system was
assembled and is available in /var/run/system_boot_time.
System-wide users (Only for Junos OS Evolved when node option is not used) Number of system-wide users.
Time Source Reference time source that the system is locked to.
System booted Date and time when the Routing Engine on the router or switch was last booted and how
long it has been running.
Protocols started Date and time when the routing protocols were last started and how long they have been
running.
395
Last configured Date and time when a configuration was last committed. Also shows the name of the user
who issued the last commit command.
time and up Current time, in the local time zone, and how long the router or switch has been operational.
load averages Load averages for the last 1 minute, 5 minutes, and 15 minutes.
Sample Output
Starting in Junos OS Evolved 19.1R1 release, the show system uptime output displays only the System booted
and System-wide users information. The output does not display the details such as Current time, System
booted, Protocols started, and Last configured parameters. To see node-specific uptime information, use the
node option.
Release Information
sfc option introduced for the TX Matrix Plus router in JUNOS Release 9.6.
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 397
Description | 399
Options | 399
Syntax
Description
Display the usage of Junos OS kernel memory listed first by size of allocation and then by type of usage.
Use the show system virtual-memory command for troubleshooting with Juniper Networks Customer
Support.
Options
all-chassis (TX Matrix routers and TX Matrix Plus routers only) (Optional) Display kernel
dynamic memory usage information for all chassis.
all-lcc (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display kernel dynamic memory usage information for all T640 routers
connected to the TX Matrix router. On a TX Matrix Plus router, display kernel
dynamic memory usage information for all connected T1600 or T4000 LCCs.
all-members (EX4200 switches and MX Series routers only) (Optional) Display kernel dynamic
memory usage information for all members of the Virtual Chassis configuration.
infrastructure (QFabric systems only) (Optional) Display kernel dynamic memory usage
name information for the fabric control Routing Engine and fabric manager Routing
Engine.
interconnect- (QFabric systems only) (Optional) Display kernel dynamic memory usage
device name information for the Interconnect device.
lcc number (TX Matrix routers and TX Matrix Plus routers only) (Optional) On a TX Matrix
router, display kernel dynamic memory usage information for a specific T640 router
that is connected to the TX Matrix router. On a TX Matrix Plus router, display
kernel dynamic memory usage information for a specific router that is connected to
the TX Matrix Plus router.
Replace number with the following values depending on the LCC configuration:
400
• 0 through 7, when T1600 routers are connected to a TX Matrix Plus router with
3D SIBs in a routing matrix.
local (EX4200 switches and MX Series routers only) (Optional) Display kernel dynamic
memory usage information for the local Virtual Chassis member.
member member- (EX4200 switches and MX Series routers only) (Optional) Display kernel dynamic
id memory usage information for the specified member of the Virtual Chassis
configuration. For EX4200 switches, replace member-id with a value from 0 through
9. For an MX Series Virtual Chassis, replace member-id with a value of 0 or 1.
node node-name (Junos OS Evolved only) (Optional) Display the kernel memory information for the
specified node. If no node is specified, information is displayed for all nodes.
node-group name (QFabric systems only) (Optional) Display kernel dynamic memory usage
information for the Node group.
scc (TX Matrix routers only) (Optional) Display kernel dynamic memory usage
information for the TX Matrix router (or switch-card chassis).
sfc number (TX Matrix Plus routers only) (Optional) Display kernel dynamic memory usage
information for the TX Matrix Plus router. Replace number with 0.
Additional Information
By default, when you issue the show system virtual-memory command on the primary Routing Engine of a TX
Matrix router or a TX Matrix Plus router, the command is broadcast to all the primary Routing Engines of
the LCCs connected to it in the routing matrix. Likewise, if you issue the same command on the backup
Routing Engine of a TX Matrix or a TX Matrix Plus router, the command is broadcast to all backup
Routing Engines of the LCCs that are connected to it in the routing matrix.
NOTE: The show system virtual-memory command with the | display XML pipe option now displays
XML output for the command in the parent tags: <vmstat-memstat-malloc>, <vmstat-memstat-zone>,
401
<vmstat-sumstat>, <vmstat-intr>, and <vmstat-kernel-state> with each child element as a separate XML
tag. In Junos OS Releases 10.1 and earlier, the | display XML option for this command does not
have an XML API element and the entire output is displayed in a single <output> tag element.
kernel direct memory map only displays for the 64-bit platform.
view
Output Fields
Table 19 on page 401 lists the output fields for the show system virtual-memory command. Output fields are
listed in the approximate order in which they appear.
Size Memory block size (bytes). The kernel memory allocator appropriates blocks of memory
whose size is exactly a power of 2.
In Use Number of memory blocks of this size that are in use (bytes).
Free Number of memory blocks of this size that are free (bytes).
HighWater Maximum value the free list can have. Once the system starts reclaiming physical memory, it
continues until the free list is increased to this value.
Couldfree Total number of times that the free elements for a bucket size exceed the high-water mark
for that bucket size.
Type(s) Kernel modules that are using these memory blocks. For a definition of each type, refer to a
FreeBSD book.
InUse Number of memory blocks used by this type. The number is rounded up.
Requests Total number of dynamic memory allocation requests this type has made.
Type Limit Number of times requests were blocked for reaching the maximum limit.
Kern Limit Number of times requests were blocked for the kernel map.
Memory Totals
Used Number of memory blocks used by this type. The number is rounded up.
Requests Total number of memory allocation requests this type has made.
Sample Output
Release Information
sfc option introduced for the TX Matrix Plus router in Junos OS Release 9.6.
RELATED DOCUMENTATION
show task
IN THIS SECTION
Syntax | 410
Description | 410
Options | 410
Syntax
show task
<logical-system (all | logical-system-name)>
<task-name>
io
logical-system-mux
memory
replication
scheduler-slip-history
snooping
summary
Description
Options
logical-system (all | (Optional) Perform this operation on all logical systems or on a particular logical
logical-system- system.
name)
logical-system-mux Display the logical router multiplexer process (lrmuxd) per-task information.
task-name (Optional) Display information about running tasks for all tasks whose name
begins with this string (for example, BGP_Group_69_153 and BGP_Group_70_153 are both
displayed when you run the show task BGP_Group command).
scheduler-slip- Show the number of scheduler slips (wherein the scheduler is unable to provide
history requested CPU time to a process) that have occurred since the last RPD start,
including some scheduler slip details.
view
Output Fields
Table 20 on page 411 describes the output fields for the show task command. Output fields are listed in
the approximate order in which they appear.
Pri Current priority of the process. A lower number indicates a higher priority.
• LowPrio— Task will be dispatched to read its socket after other higher-priority tasks.
Sample Output
show task
50 BGP_Group_70_153 <LowPrio>
50 ASPaths
60 KRT 255 1
60 Redirect
70 MGMT.local 14 <LowPrio>
70 MGMT_Listen./var/run/rpd_mgmt 13 <Accept LowPrio>
70 SNMP Subagent./var/run/sub_rpd.sock 8 <LowPrio>
40 KRT IO task {krtio-th}
40 krtio-th {krtio-th}
60 krt solic client 255 85 <ReadDisableWriteDisable> {krtio-th}
13 rsvp-iobagent./var/run/sub_rpd.sock 46 <WriteDisable> {rsvp-io}
80 jtrace_jthr_task 255 85 {TraceThread}
Release Information
RELATED DOCUMENTATION
show task io
IN THIS SECTION
Syntax | 414
Description | 414
Options | 415
Syntax
show task io
<logical-system (all | logical-system-name)>
show task io
Description
Display I/O statistics for routing protocol tasks on the Routing Engine.
415
Options
none Display I/O statistics for routing protocol tasks on the Routing Engine.
logical-system (all | logical- (Optional) Perform this operation on all logical systems or on a particular
system-name) logical system.
view
Output Fields
Table 21 on page 415 describes the output fields for the show task io command. Output fields are listed
in the approximate order in which they appear.
Sample Output
show task io
...
417
Release Information
IN THIS SECTION
Syntax | 417
Description | 417
Options | 417
Syntax
Description
Options
none Display all the logical router multiplexer process (lrmuxd) per-task information.
418
task-name (Optional) Display information about running tasks for all tasks whose name begins with
this string (for example, lsys_session_task:lr2 and lsys_session_task:lr1 are both displayed
when you run the show task logical-system-mux lsys command).
view
Output Fields
Table 22 on page 418 describes the output fields for the show task logical-system-mux command. Output
fields are listed in the approximate order in which they appear.
Pri Current priority of the process. A lower number indicates a higher priority.
• LowPrio— Task will be dispatched to read its socket after other higher-priority tasks.
Sample Output
Release Information
RELATED DOCUMENTATION
IN THIS SECTION
Syntax | 421
Description | 421
Options | 421
Syntax
Description
Display memory utilization for routing protocol tasks on the Routing Engine.
NOTE: The show task memory command does not display all the memory used by the routing
protocol process. This value does not account for the memory used for the TEXT and STACK
segments, or the memory used by the routing protocol process’s internal memory manager.
Options
none Display standard information about memory utilization for routing protocol
tasks on the Routing Engine on all logical systems.
brief | detail | history | (Optional) Display the specified level of output. Use the history option to
summary display a history of memory utilization information.
logical-system (all | (Optional) Perform this operation on all logical systems or on a particular
logical-system-name) logical system.
view
422
Output Fields
Table 23 on page 422 describes the output fields for the show task memory command. Output fields are
listed in the approximate order in which they appear.
Memory Currently Memory currently in use. Dynamically allocated memory plus the DATA All levels
In Use segment memory in kilobytes.
Program data+BSS Program and base station subsystem (BSS) memory. detail
memory
Total bytes in Total memory, in bytes, that is currently in use and percentage of detail
use available memory (in parentheses).
Sample Output
Release Information
IN THIS SECTION
Syntax | 427
Description | 427
Options | 427
Syntax
Description
Displays nonstop active routing (NSR) status. When you issue this command on the primary Routing
Engine, the status of nonstop active routing synchronization is also displayed.
Options
view
Output Fields
Table 24 on page 428 lists the output fields for the show task replication command. Output fields are
listed in the approximate order in which they appear.
428
Stateful replication Displays whether or not graceful Routing Engine switchover is configured. The
status can be Enabled or Disabled.
RE mode Displays the Routing Engine on which the command is issued: Master, Backup,
or Not applicable (when the router has only one Routing Engine).
Synchronization Status Nonstop active routing synchronization status for the supported protocols.
States are NotStarted, InProgress, and Complete.
Synchronization states are shown for each of the supported protocols that are
running on the device at that moment.
Sample Output
In Junos OS Evolved, both the primary and backup Routings have the same CLI output. If you configured
any protocol, you should see the synchronization state for the same.
Release Information
RELATED DOCUMENTATION