Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show system applications (Junos OS Evolved)

date_range 21-Feb-25

Syntax

content_copy zoom_out_map
show system applications
<app app-name> 
<brief>
<detail>
<error>
<node node-name>

Description

This command displays application summary information in one of the following forms:

  • Shows all application summary information for all nodes.

  • Shows the application summary information for a specific application.

  • Shows the application summary information for a specific node.

On ACX7000 series of routers, when an application restarts for more than three times in a five-minute window, then the application and its dependent applications goes into a failure state. The reason for an application restart could be anything like an application crash, restart of other dependent applications, Routing Engine switchover, CLI induced restart, et cetera.

If an application goes into a failed state, then you need to manually recover the application by using the following CLI command:

content_copy zoom_out_map
user@host> restart app-name

You can use the show system applications command to check the status of all the applications.

You can use the following shell command to understand the reason for an application failure:

content_copy zoom_out_map
user@host:/etc/systemd/system# systemctl status app-name

The following sample output helps you to understand the reason for the evo-pfemand application failure:

content_copy zoom_out_map
user@host:/etc/systemd/system# systemctl status evo-pfemand
x evo-pfemand.service - "Evo Merchant Silicon PFE Manager Daemon"
     Loaded: loaded (/etc/systemd/system/evo-pfemand.service; static)
     Active: failed (Result: signal) since Mon 2024-09-23 22:27:13 PDT; 53min ago
    Process: 32689 ExecStartPre=/usr/sbin/evo-pfemand_prestart.sh (code=exited, status=0/SUCCESS)
    Process: 32698 ExecStart=/usr/sbin/evo-pfemand_start.sh evo-pfemand (code=killed, signal=KILL)
    Process: 2827 ExecStopPost=/usr/sbin/evo-pfemand_poststop.sh evo-pfemand (code=exited, status=0/SUCCESS)
   Main PID: 32698 (code=killed, signal=KILL)
 
Sep 23 22:27:13 host systemd[1]: evo-pfemand.service: Converting job evo-pfemand.service/restart -> evo-pfemand.service/start
Sep 23 22:27:13 host systemd[1]: evo-pfemand.service: Start request repeated too quickly.
Sep 23 22:27:13 host systemd[1]: evo-pfemand.service: Failed with result 'signal'.
Sep 23 22:27:13 host systemd[1]: evo-pfemand.service: Service restart not allowed.

The output shows that the evo-pfemand application has failed and the reason is that the application has hit the start limit. In this case, you will need to manually restart the evo-pfemand application by using the following command:

content_copy zoom_out_map
user@host> restart evo-pfemand

To know how to use shell commands on Junos OS Evolved, see Shell Commands for Junos OS Evolved.

Options

app app-name

(Optional) Specify application name for which you want to display application summary information.

brief

(Optional) Display brief output. This is the default format of display.

detail

(Optional) Display detailed output.

error (Optional) Display information about errors. You can specify the app, node, and detail options at the same time to further refine the list of errors, and to get more information about each one.
node node-name

(Optional) Specify node name for which you want to display application summary information.

Required Privilege Level

view

Output Fields

For a description of the output fields, see Table 1. Output fields are listed in the approximate order in which they appear.

Table 1: show system applications Output Fields

Field Name

Description

Level

Applications Information

Application

Name of the application.

Node

Name of the node the application is running on.

App State

State of the application: online, offline, failed, or active.

App Weight

A relative weight for multiple instances of the application across multiple nodes. The application instance with the higher weight provides more functionality.

App Zookeeper Session

Zookeeper session ID.

all options, except error

Object Producer details

Producer ID

Identifies which production set the object is part of.

Epoch ID

A number that identifies the current process that owns a production set. There can only be one owning process (active producer) that owns a production set at one time. The current owning process has an Epoch ID that is larger than any previous producer.

Production Topic

Hierarchical string that represents the production set.

Producer State

active or standby:

  • active indicates the application has production rights to modify the state in the production set.

  • standy means that the application is waiting to get the production right for the production set.

all options, except error

Description

A short description of the application, it also lists the systemd service file used for the application.

detail, without the error option

Loaded

A systemd state that indicates if the application is loaded in the system or not.

detail, without the error option

Run State from OS

A systemd state that indicates if the application is active or not.

detail, without the error option

Main PID

Process identifier (PID) of the application.

detail, without the error option

Command

Command line to launch the application.

detail, without the error option

ID

Name of the application.

detail, without the error option

Meta

Meta data for the application includes the following fields:

Bin path

Path to application execution.

Log file

Where logs go.

Working Dir

Working directory.

Production Set

Global or local production set. Values might be shared or local.

detail, without the error option

Resource

Resource data for the application includes the following fields:

all nodes

Does the application run on all nodes, true or false.

Max instances

How many instances of the application are there.

Max instances per node

How many instances of the application per node are there.

Run on startup

Is the application launched at bootup, true or false.

Node attributes

Typical node attributes are RE, FPC, MasterRE. You can see the node attributes by using the show system node-attributes command.

Node attribute match

What is the node attribute required to launch this application on a node? For example, if this field has the output re, Service file: lfmd, it indicates that the process lfmd will be launched on a node that has the attribute RE.

detail, without the error option

Failure

Failure data for the application includes the following fields:

Alarm color

Which alarm to be raised on failure, or none.

Alarm ID

The alarm ID.

Restart

Whether to restart the application, true or false.

detail, without the error option

Upgrade

Upgrade data for the application includes the following fields:

Upgrade parallely

Options are true or false.

Node upgrade done notify

Application requires notification when node upgrade is done. Options are true or false.

System upgrade done notify

Application requires notification when system upgrade is done. Options are true or false.

Upgrade restart node

Options are true or false.

Upgrade style

Option is stop-start.

hw sync

Application requires notification to sync hardware state during a unified in-service software upgrade (unified ISSU). Options are true or false.

wait for sw sync

Application provides notification after it has synced software state during a unified in-service software upgrade (unified ISSU). Options are true or false.

prepare to upgrade final

Application requires notification to prepare for upgrade. Options are true or false.

exits on prep final

Application exits after processing prepare to upgrade. Options are true or false.

Weight Application weight.

detail, without the error option

App-Exit

App-Exit data for the application includes the following fields:

Restart Supported

True/false. When the application exits, should the application be restarted.

Restart Node

True/false. When the application exits, should the node be rebooted.

Mark node spare

When an application exits, should the node be marked spare.

detail, without the error option

Node

Name of the node the application is running on.

error option, all combinations

Application

Name of the application.

error option, all combinations

Error Count

How many errors are on the node for the stated application.

error detail, either with or without the app or node options

Error Guids

Identifiers for particular error instances.

error detail, either with or without the app or node options

Error Number

Identifier for a particular type of error. For example, number 3 is for the error "No such process".

error detail, either with or without the app or node options

Severity

How severe the error is.

error detail, either with or without the app or node options

GUID

Identifier for a particular error instance.

error detail, either with or without the app or node options

Error Description

Text describing the error.

error detail, either with or without the app or node options

Error Module

The module causing the error.

error detail, either with or without the app or node options

Error Object Name

Name of the object causing the error.

error detail, either with or without the app or node options

Error Object Parent Name

Name of the object's parent.

error detail, either with or without the app or node options

Error Timestamp

Date and time at which the error occurred.

error detail, either with or without the app or node options

Sample Output

show system applications

content_copy zoom_out_map
user@host> show system applications
Applications Information:
Application             : bcmd_evo
Node                    : fpc0
App State              : offline 
Object Producer details
Producer ID             : 0
  Epoch ID                : 0

Applications Information:
Application             : ccdpfe
Node                    : fpc0
App State              : online 
Object Producer details
Producer ID             : 576
  Epoch ID                : 65
  Production Topic        : /Root/fpc0/ccdpfe/100143551468101228
  Producer State          : active

Applications Information:
Application             : cmdd
Node                    : fpc0
App State              : online 
Object Producer details
Producer ID             : 570
  Epoch ID                : 66
  Production Topic        : /Root/fpc0/cmdd/1099227235289688912
  Producer State          : active

...

Applications Information:               
Application             : alarm-mgmtd
Node                    : re0
App State              : online 
Object Producer details
Producer ID             : 26
  Epoch ID                : 1
  Production Topic        : /Root/alarm-mgmtd/2988563069668674039
  Producer State          : active

Applications Information:
Application             : alarmd
Node                    : re0
App State              : online 
Object Producer details
Producer ID             : 377
  Epoch ID                : 30
  Production Topic        : /Root/alarmd/6512784671716237713
  Producer State          : active

Applications Information:
Application             : arpd
Node                    : re0
App State              : online 
Object Producer details
Producer ID             : 396
  Epoch ID                : 41
  Production Topic        : /Root/arpd/14284058728950342139
  Producer State          : active

...

Applications Information:               
Application             : alarm-mgmtd
Node                    : re1
App State              : online 
Object Producer details
Producer ID             : 26
  Epoch ID                : 0
  Production Topic        : /Root/alarm-mgmtd/2988563069668674039
  Producer State          : standby

Applications Information:
Application             : bcmd_evo
Node                    : re1
App State              : offline 
Object Producer details
Producer ID             : 0
  Epoch ID                : 0

Applications Information:
Application             : charonctl
Node                    : re1
App State              : online 
Object Producer details
Producer ID             : 25
  Epoch ID                : 4
  Production Topic        : /Root/re1/charonctl/10854553120394604032
  Producer State          : active

...

show system applications error

content_copy zoom_out_map
{master}
user@host-re0> show system applications error
Error Summary:
Node                : fpc0
Application         : evo-aftmand-bt
Error Count         : 3
Error Guids:
    1249835833539
    1249835833540
    1249835833541

Error Summary:
Node                : re0
Application         : rpdagent
Error Count         : 3
Error Guids:
    1249835833539
    1249835833540
    1249835833541

show system applications error node node-name

content_copy zoom_out_map
user@host-re0> show system applications error node fpc0
Error Summary:
Node                : fpc0
Application         : evo-aftmand-bt
Error Count         : 3
Error Guids:
    1249835833539
    1249835833540
    1249835833541

show system applications error app application-name

content_copy zoom_out_map
user@host-re0> show system applications error app rpdagent
Error Summary:
Node                : re0
Application         : rpdagent
Error Count         : 3
Error Guids:
    1249835833539
    1249835833540
    1249835833541

show system applications app application-name node node-name

content_copy zoom_out_map
user@host> show system applications app alarm-mgmtd node re1
Applications Information:
Application             : alarm-mgmtd
Node                    : re1
App State              : online 
Object Producer details
Producer ID             : 26
  Epoch ID                : 0
  Production Topic        : /Root/alarm-mgmtd/2988563069668674039
  Producer State          : standby

show system applications app application-name detail

content_copy zoom_out_map
user@host> show system applications app cmdd detail
Applications Information:
Application             : cmdd
Node                    : re0  
App State               : online ready 
App Weight              : 1 
App Zookeeper Session   : 1000000934d000d
Object Producer details
Producer ID             : 50331736
  Epoch ID                : 47
  Production Topic        : /Root/re0/cmdd/3158206796014561683
  Producer State          : active
Description             : cmdd.service - "Command Daemon"
Loaded                  : loaded (/etc/systemd/system/cmdd.service;static;vendor preset:enabled)
Run State from OS       : active (running) (Result: success) since Mon 2018-10-29 05:02:24 PDT
Main PID                : 5814
Command                 : /usr/sbin/cmdd --app-name cmdd -I object_select --shared-objects-mode 3
App Config Info
 ID                     : cmdd
 Meta
  Bin path              : /usr/sbin/cmdd
  Log file              : /var/log
  Working Dir           : /usr/sbin
  Production Set        : local
  Sysman Managed        : true
  Type Evo              : true
 Resource
  All nodes             : true
  Max instances         : 1
  Max instances per node: 1
  App Suite             : default,diags_default
  Run on startup        : true
  Node attributes       :
(Node attribute match  : *, Service file  : cmdd)
 Failure
  Alarm color           : red
  Restart Node          : false
  Mark node spare       : false
 Upgrade
  Upgrade parallely           : true
  Upgrade restart node        : false
  Upgrade style               : stop-start
 App-Exit
  Restart Supported           : true
  Restart Node                : false
  Mark node spare             : false

show system applications error app application-name detail

content_copy zoom_out_map
user@host-re0> show system applications error app rpdagent detail
Error detail:
Node                           : re0
Application                    : rpdagent
Error Number                   : 3
Severity                       : FATAL
GUID                           : 1249835833539
Error Description              : No such process
Error Module                   : CHASSIS0:FPC0
Error Object Name              : proto: ipv4 prefix: 10.35.1.1
Error Object Parent Name       : Type:RtTable : default.inet
Error Timestamp                : Thu Aug 18 03:54:34 2022

Node                           : re0
Application                    : rpdagent
Error Number                   : 3
Severity                       : FATAL
GUID                           : 1249835833540
Error Description              : No such process
Error Module                   : CHASSIS0:FPC0
Error Object Name              : proto: ipv4 prefix: 10.35.1.2
Error Object Parent Name       : Type:RtTable : default.inet
Error Timestamp                : Thu Aug 18 03:54:34 2022

Node                           : re0
Application                    : rpdagent
Error Number                   : 3
Severity                       : FATAL
GUID                           : 1249835833541
Error Description              : No such process
Error Module                   : CHASSIS0:FPC0
Error Object Name              : proto: ipv4 prefix: 10.35.1.3
Error Object Parent Name       : Type:RtTable : default.inet
Error Timestamp                : Thu Aug 18 03:54:34 2022

show system applications error app application-name node node-name detail

content_copy zoom_out_map
{master}
user@host-re0> show system applications error app evo-aftmand-bt node fpc1 detail
Error detail:
Node                           : fpc1
Application                    : evo-aftmand-bt
Error Number                   : 1001
Severity                       : FATAL
GUID                           : 1151051261231
Error Description              : Generic failure
Error Module                   : FPC:1/pfe/rt
Error Object Name              : proto: ipv4 prefix: 10.32.1.1
Error Object Parent Name       : Type:RtTable : default.inet

Release Information

Command introduced in Junos OS Evolved Release 18.3R1.

error option added in Junos OS Evolved Release 22.3R1.

footer-navigation