Troubleshooting the Network Monitoring Page Is Not Available Issue | 77
Troubleshooting DMI Schema–Related Issues | 78
Troubleshooting the Nondisplay of the DMI Schema Tree Issue | 78
vi
About the Documentation
IN THIS SECTION
Documentation and Release Notes | vii
Documentation Conventions | vii
Documentation Feedback | x
Requesting Technical Support | x
Use this guide to know about the various features, such as Systems of Record, System Snapshot, Audit
Logs, Looking Glass, and so on, that you can use to monitor and troubleshoot devices; and also, know
about procedures to troubleshoot issues, such as login-related issues, device management-related issues,
DMI schema-related issues, and so on, in Junos Space Platform.
vii
Documentation and Release Notes
To obtain the most current version of all Juniper Networks®technical documentation, see the product
documentation page on the Juniper Networks website at https://www.juniper.net/documentation/.
If the information in the latest release notes differs from the information in the documentation, follow the
product Release Notes.
Juniper Networks Books publishes books by Juniper Networks engineers and subject matter experts.
These books go beyond the technical documentation to explore the nuances of network architecture,
deployment, and administration. The current list can be viewed at https://www.juniper.net/books.
Documentation Conventions
Table 1 on page viii defines notice icons used in this guide.
Table 1: Notice Icons
viii
DescriptionMeaningIcon
Indicates important features or instructions.Informational note
Caution
Indicates a situation that might result in loss of data or hardware
damage.
Alerts you to the risk of personal injury or death.Warning
Alerts you to the risk of personal injury from a laser.Laser warning
Indicates helpful information.Tip
Alerts you to a recommended use or implementation.Best practice
Table 2 on page viii defines the text and syntax conventions used in this guide.
Table 2: Text and Syntax Conventions
ExamplesDescriptionConvention
Fixed-width text like this
Italic text like this
Represents text that you type.Bold text like this
Represents output that appears on
the terminal screen.
Introduces or emphasizes important
•
new terms.
Identifies guide names.
•
Identifies RFC and Internet draft
•
titles.
To enter configuration mode, type
the configure command:
user@host> configure
user@host> show chassis alarms
No alarms currently active
A policy term is a named structure
•
that defines match conditions and
actions.
Junos OS CLI User Guide
•
RFC 1997, BGP Communities
•
Attribute
Table 2: Text and Syntax Conventions (continued)
ix
ExamplesDescriptionConvention
Italic text like this
Text like this
< > (angle brackets)
| (pipe symbol)
Represents variables (options for
which you substitute a value) in
commands or configuration
statements.
Represents names of configuration
statements, commands, files, and
directories; configuration hierarchy
levels; or labels on routing platform
components.
variables.
Indicates a choice between the
mutually exclusive keywords or
variables on either side of the symbol.
The set of choices is often enclosed
in parentheses for clarity.
Configure the machine’s domain
name:
[edit]
root@# set system domain-name
domain-name
To configure a stub area, include
•
the stub statement at the [edit
protocols ospf area area-id]
hierarchy level.
The console port is labeled
•
CONSOLE.
stub <default-metric metric>;Encloses optional keywords or
broadcast | multicast
(string1 | string2 | string3)
# (pound sign)
[ ] (square brackets)
Indention and braces ( { } )
; (semicolon)
GUI Conventions
Indicates a comment specified on the
same line as the configuration
statement to which it applies.
Encloses a variable for which you can
substitute one or more values.
Identifies a level in the configuration
hierarchy.
Identifies a leaf statement at a
configuration hierarchy level.
rsvp { # Required for dynamic MPLS
only
community name members [
community-ids ]
[edit]
routing-options {
static {
route default {
nexthop address;
retain;
}
}
}
Table 2: Text and Syntax Conventions (continued)
x
ExamplesDescriptionConvention
Bold text like this
> (bold right angle bracket)
Represents graphical user interface
(GUI) items you click or select.
Separates levels in a hierarchy of
menu selections.
In the Logical Interfaces box, select
•
All Interfaces.
To cancel the configuration, click
•
Cancel.
In the configuration editor hierarchy,
select Protocols>Ospf.
Documentation Feedback
We encourage you to provide feedback so that we can improve our documentation. You can use either
of the following methods:
Online feedback system—Click TechLibrary Feedback, on the lower right of any page on the Juniper
•
Networks TechLibrary site, and do one of the following:
Click the thumbs-up icon if the information on the page was helpful to you.
•
Click the thumbs-down icon if the information on the page was not helpful to you or if you have
•
suggestions for improvement, and use the pop-up form to provide feedback.
E-mail—Send your comments to techpubs-comments@juniper.net. Include the document or topic name,
•
URL or page number, and software version (if applicable).
Requesting Technical Support
Technical product support is available through the Juniper Networks Technical Assistance Center (JTAC).
If you are a customer with an active Juniper Care or Partner Support Services support contract, or are
covered under warranty, and need post-sales technical support, you can access our tools and resources
online or open a case with JTAC.
JTAC policies—For a complete understanding of our JTAC procedures and policies, review the JTAC User
•
Guide located at https://www.juniper.net/us/en/local/pdf/resource-guides/7100059-en.pdf.
JTAC hours of operation—The JTAC centers have resources available 24 hours a day, 7 days a week,
•
365 days a year.
Self-Help Online Tools and Resources
For quick and easy problem resolution, Juniper Networks has designed an online self-service portal called
the Customer Support Center (CSC) that provides you with the following features:
Monitoring Network Devices and Troubleshooting Software Issues with Junos Space Network Management
Platform | 2
Overall System Condition and Fabric Load History Overview | 6
Junos Space Network Management Platform Widgets | 9
2
Monitoring Network Devices and Troubleshooting Software Issues with
Junos Space Network Management Platform
IN THIS SECTION
Systems of Record | 3
System Snapshot | 3
Backup and Restore | 3
Maintenance Mode | 4
Audit Logs | 4
Jobs | 4
Secure Console | 5
Looking Glass | 5
Reports | 5
Junos Space Debug Utilities | 6
Use the following features of Junos Space Network Management Platform to monitor devices and
troubleshoot software issues:
Systems of Record
A network managed by Junos Space Platform contains two repositories of information about the devices
in the network: the devices themselves (each device defines and reports its official state) and the database
(which contains information that is reported by the device during device discovery). This is known as
systems of record.
The systems of record operate in the following two modes depending on where the repository of information
is stored:
Network as a system of record (NSOR)—By default, the network is the system of record (NSOR). In this
•
mode, when a user commits a change in the configuration of a network device, the commit operation
automatically triggers a report through the system log to Junos Space Platform.
Junos Space as a system of record (SSOR)—In this mode, when you perform any out-of-band commit
•
operation, Junos Space Platform receives a system log message from the device, but the values in the
Junos Space Platform database are not automatically changed or synchronized with the values on the
device. Instead, you can choose whether or not to overwrite the device's local changes by pushing the
accepted configuration to the device from the Junos Space Platform database. For more information
about systems of record in Junos Space Platform, see Systems of Record in Junos Space Overview.
3
System Snapshot
You can use the System Snapshot feature to create a snapshot of the current state of the Junos Space
system. The snapshot includes all persistent data on the hard disk including data in the database, system
and application configuration files, and application and Linux executables. You can roll back the Junos
Space system to a predefined state or an older release if the system reaches an unrecoverable error state
caused by undesirable behavior due to corruption of system files, interruption of critical processes, and
so on. The System Snapshot is a fabric-wide operation that maintains consistency of data across all nodes
in the fabric.
You can create a snapshot before a significant action is performed—for example, adding or deleting a Junos
Space node, installing a Junos Space application, and so on—because the action can precipitate the system
into an undesirable state. You can delete the snapshot after you have ascertained that the action was
performed successfully. For more information about system snapshots, see Creating a System Snapshot.
Backup and Restore
You use the Backup and Restore feature to back up (or schedule the backup of) and restore the data in
the Junos Space database. You can set up an hourly, daily, or weekly schedule. The database backup can
be stored on the local Junos Space system or transferred to a remote system automatically using the Secure
Copy mechanism.
You can restore the backup in any of the following circumstances:
Junos Space data is corrupted and you need to replace the corrupted data with uncorrupted data.
•
Junos Space software is corrupted and unstable after a reinstallation or an upgrade and you need to
•
populate the Junos Space database with uncorrupted data.
For more information about backup and restore operations, see Backing Up and Restoring the DatabaseOverview.
Maintenance Mode
Maintenance mode is a mode in which you can perform database restore and debugging tasks while all
nodes in the fabric are shut down and the Junos Space Network Management Platform Web proxy is
running. You need to be an authorized Junos Space administrator to put the system into maintenance
mode. You can put the system into maintenance mode only after you initiate a restore task by using the
Backup and Restore feature.
4
The Junos Space system goes into maintenance mode in the following situations:
Junos Space Network Management Platform software goes down.
•
You initiate a restore operation by using the Backup and Restore feature.
•
You upgrade the Junos Space Network Management Platform software.
•
For more information about maintenance mode, see Maintenance Mode Overview.
Audit Logs
The Audit Logs workspace of Junos Space Platform displays the login history and tasks initiated by a local
or remote user. Through this workspace, you can track login history, view the list of device management
tasks, view the list of services that were provisioned on the device, and so on. However, tasks that are not
initiated by users, such as device-driven activities (for example, resynchronization of network elements),
and changes made from the Junos Space CLI are not recorded in audit logs. Audit logs can be used by
administrators to review events—for example, to identify which user accounts are associated with an event,
to determine the chronological sequence of events (that is, what happened before and during an event),
and so on. For more information about audit logs, see Junos Space Audit Logs Overview.
Jobs
You use the Jobs workspace of Junos Space Platform to monitor the status of jobs that are run in Junos
Space Platform and all Junos Space applications installed on Junos Space Platform. You can view the status
of the jobs on the Job Management page. A job is a user-initiated action that is performed on any object
that is managed by Junos Space Platform, such as a device, service, or customer. Typical jobs in Junos
Space Network Management Platform include discovering devices, deploying services, prestaging devices,
and performing functional and configuration audits.
You can trigger jobs immediately or schedule jobs for a later date and time. Junos Space Platform maintains
a history of job statuses for all scheduled jobs. When a job is scheduled from a workspace, Junos Space
Platform assigns a job ID that serves to identify the job on the Job Management page. For more information
about jobs, see Jobs Overview.
Secure Console
The Secure Console feature on the Devices workspace provides a secure remote access connection to
managed and unmanaged devices. Secure Console initiates an SSH session from the Junos Space user
interface by using the SSH protocol. Secure Console is a terminal window embedded in Junos Space
Platform that eliminates the need for a third-party SSH client to connect to devices. Secure Console
provides additional security while connecting to your devices by initiating an SSH session from the Junos
Space server rather than from your Web browser. You can access the Secure Console feature either from
the Device Management page or the Secure Console page. For more information about Secure Console,
see Secure Console Overview.
5
Looking Glass
You use the Looking Glass feature from the Devices workspace to view device configurations by executing
basic CLI commands from the Junos Space user interface. You can execute these commands on multiple
devices and compare the configurations and runtime information of these devices. You can execute the
following types of commands by using Looking Glass: show, ping, test, and traceroute. The commands
that are supported and stored in the Junos Space Platform database are displayed on the Looking Glass
page. When you type the first few letters of the command, the suggestion list displays the commands that
are supported, are stored, and begin with the letters that you typed. For more information about Looking
Glass, see Looking Glass Overview.
Reports
With the Reports workspace of Junos Space Platform, you can generate customized reports for managing
the resources in your network. You can use these reports to gather device inventory details, job execution
details, user accounts, and audit trails. You first create a report definition to specify what information to
retrieve from the Junos Space Platform inventory database. You then use this report definition to generate,
export, and print the reports. Junos Space Platform provides some predefined categories to create report
definitions. You can combine multiple categories to create a report definition. By default, a predefined set
of attributes is included in a report definition. You can choose to add or remove the attributes according
to what information you want from the final generated report. You can group, sort, or filter data based on
specific attributes available with the report definition. For more information about reports, see ReportsOverview.
Junos Space Debug Utilities
Junos Space debug utilities are a collection of scripts and Java applications to fetch details that cannot be
viewed on the JBoss CLI or from the Junos Space user interface. These scripts and Java applications are
stored at /var/log/space-debug/debug-utilities and categorized under deviceConnection, jobManagement,
deviceImport, and HornetQ directories. When you execute these scripts or Java applications, you can view
details such as device-connection or node-connection issues, device XMLs fetched from the Junos Space
Platform database, and jobs triggered and nodes that execute these jobs. For more information about
Junos Space debug utilities, see “Junos Space Debug Utilities Overview” on page 33.
RELATED DOCUMENTATION
Overall System Condition and Fabric Load History Overview | 6
Junos Space Network Management Platform Widgets | 9
6
Overall System Condition and Fabric Load History Overview
You can view the overall Junos Space system condition and fabric load from the Junos Space Network
Management Platform Dashboard or the Administration statistics page.
Overall System Condition
To calculate the overall Junos Space system condition, Junos Space Platform uses a formula based on
cluster health and node-function health:
Cluster health indicates the percentage of nodes in the fabric that are currently running.
•
For example, if only three nodes are reachable in a four-node fabric, cluster health is 75%.
Load-balancer health indicates the percentage of nodes (enabled for load balancing) that are running
•
the load-balancing process.
For example, if two nodes are enabled for load balancing and the load-balancing process is running on
only one node, the load-balancing health is 50%.
Database health indicates the percentage of nodes (enabled for database requests) that are running the
•
database process.
For example, if two nodes are enabled as the database server and the database process is running on
only one node, then database health is 50%.
Application-logic health indicates the percentage of nodes (enabled for application logic (DML and
•
business logic) that are running the application-logic process.
For example, if three nodes are enabled for application logic and the application-logic process is running
on only two nodes, then application-logic health is 67%.
Junos Space Platform retrieves data on the nodes and the node functions that are running, and then applies
the following formula to determine the overall Junos Space system condition: Overall System Condition
= [(Number of Nodes Running) / (Number of Nodes in Fabric)] * [(Number of Nodes Running Load_Balancing
Process) / (Number of Nodes enabled for Load Balancing)] * [(Number of Nodes Running Database-Server
Process) / (Number of Nodes Enabled As Database Server)] * [(Number of Nodes Running Application-Logic
Process) / (Number of Nodes Enabled for Application Logic)]
The overall Junos Space system condition is expressed as a percentage. If we use the values in the preceding
examples in this formula, then the overall system condition would be calculated as: Overall System Condition
= 75% * 50%* 50% * 67% = 12.5%.
A value between 0 and 30% indicates that the system health is Poor, a value between 30% and 70%
indicates that the system health is average, and a value between 70% and 100% indicates that the system
health is good. The Overall System Condition chart displays the system health as shown in
Figure 1 on page 7
7
Figure 1: Overall System Condition Gauge
The overall system health indicates 0% (Poor) when any one of the following conditions is detected:
No nodes in the fabric are running.
•
No nodes enabled for load balancing are running the load-balancing process.
•
No nodes enabled for database requests are running the database process.
•
No nodes enabled for application logic are running the application-logic process.
•
Fabric Load History
The Fabric Load History chart, as shown in Figure 2 on page 8, displays the average CPU usage across
all nodes that are running in the fabric.
Figure 2: Fabric Load History Chart
Junos Space Platform uses the following formula to determine the fabric load: Fabric Load = (Total CPU
Usage for All Nodes Running) / (Number of Nodes Running)
For example, for a fabric with three nodes running and CPU usage of 80%, 30%, and 10%, respectively,
the fabric load is 40%.
Active Users History
8
The Active Users History chart, as shown in Figure 3 on page 8, displays the number of active users in
the past one minute.
Figure 3: Active Users History Chart
RELATED DOCUMENTATION
Viewing the Junos Space Platform Dashboard
Viewing the Administration Statistics
Junos Space Network Management Platform Widgets
IN THIS SECTION
Devices | 9
Device Templates | 9
CLI Configlets | 10
Images and Scripts | 10
Reports | 10
Network Monitoring | 11
Configuration Files | 11
Jobs | 11
Role Based Access Control | 12
Audit Logs | 12
9
Administration | 12
This topic presents a list of workspaces in Junos Space Network Management Platform and the widgets
that they display:
Devices
The Devices workspace displays the following widgets:
Device Count by Platform—Number of Juniper Networks devices added per device platform
•
Device Status—Percentage of devices with the UP, Down, or NA connection status
•
Device Count by OS—Number of devices running a particular Junos OS version
•
Device Count by Synchronization State—Device discovery targets that were discovered, failed, are
•
managed
For more information about these widgets, refer to the Viewing Device Statistics topic in the Junos SpaceNetwork Management Platform Workspaces Feature Guide.
Device Templates
The Device Templates workspace displays the following widgets:
Template Status—Percentage of device templates with the Enabled and Need Review statuses
•
Template Definition Status—Percentage of device templates that are Published and Unpublished statuses
•
Template Count by Device Family—Number of device templates created per device family
•
For more information about these widgets, refer to the Viewing Device Template Statistics and Viewing
Template Definition Statistics topics in the Junos Space Network Management Platform Workspaces Feature
Guide.
CLI Configlets
The CLI Configlets workspace displays the following widgets:
CLI Configlet Count by Device Family—Number of CLI configlets created per device family
•
Configuration Viewer Count by Device Family—Number of configuration views per device family
•
For more information about these widgets, refer to the Viewing CLI Configlet Statistics and Viewing
Configuration Views Statistics topics in the Junos Space Network Management Platform Workspaces Feature
Guide.
10
Images and Scripts
The Images and Scripts workspace displays the following widgets:
Device Image Count by Platform Group—Number of device images per platform group
•
Device Images Count by Version—Number of device images created per Junos OS version
•
Number of Scripts by Type—Number of scripts created per script type. The script types are : Commit,
•
Op, and Event
Number of Jobs per Script Action—Number of jobs triggered by different script-related actions
•
For more information about these widgets, refer to the Viewing Statistics for Device Images and Scripts topic
in the Junos Space Network Management Platform Workspaces Feature Guide.
Reports
The Reports workspace displays the following widgets:
Report Definition Count by User—Number of report definitions created per user
•
Report Count by User—Number of reports created per user
•
For more information about these widgets, refer to the Viewing Report Statistics and Viewing Report Definition
Statistics topics in the Junos Space Network Management Platform Workspaces Feature Guide.
Network Monitoring
The Network Monitoring workspace displays the following widgets:
Nodes with Pending Problems—Nodes with outstanding alarms
•
Nodes with Outages—Nodes that reported outages
•
Availability Over the Past 24 hours—Number and percentage availability of the network interfaces of
•
the devices that reported outages
Notification—Check for notifications sent to you, all Junos Space Platform users, and the on-call schedule
•
to fix outages.
Resource Graphs—Search for resource graphs. Resource graphs display data collected from managed
•
nodes throughout your network such as critical SNMP performance, response time, and so forth.
KSC Reports—Search for key SNMP customized (KSC) reports. KSC reports enable you to create and
•
view SNMP performance data using prefabricated graph types.
Quick Search—Search for nodes by node ID, node label, IP address, or the type of service whether ICMP
•
or SNMP.
11
For more information about these widgets, refer to the Network Monitoring Reports Overview topic in the
Junos Space Network Management Platform Workspaces Feature Guide.
Configuration Files
The Configuration Files workspace displays the following widgets:
Configuration File Count by Device Family—Number of configuration files per device family
•
Devices with most Frequently Revised Configuration Files—Devices whose configuration files have been
•
revised most number of times
For more information about these widgets, refer to the Viewing Configuration File Statistics topic in the
Junos Space Network Management Platform Workspaces Feature Guide.
Jobs
The Jobs workspace displays the following widgets:
Job Types—Percentage of all jobs of a particular type that are run
•
State of Jobs Run—Percentages of jobs that succeeded, are canceled, are in progress, or failed
•
Average Execution Time per Completed Job— Each bar in the Average Execution Time per Completed
•
Job bar chart represents a job type and the average execution time in seconds.
For more information about these widgets, refer to the Viewing Statistics for Jobs topic in the Junos SpaceNetwork Management Platform Workspaces Feature Guide.
Role Based Access Control
The Role Based Access Control workspace displays the following widget:
Number of Users Assigned by Role—Percentage and the number of users that are assigned to a role
•
For more information about these widgets, refer to Viewing User Statistics.
Audit Logs
The Audit Logs workspace displays the following widgets:
Audit Log Statistical Graph—Tasks that are performed and logged in all Junos Space applications over a
•
specific period of time
Top 10 Active Users in 24 hours—Top ten users who performed the most number of tasks over 24 hours
•
12
For more information about these widgets, refer to the Viewing Audit Log Statistics topic in the Junos Space
Network Management Platform Workspaces Feature Guide.
Administration
The Administration workspace displays the following widgets:
System Health—Junos Space system condition, load on the fabric, and active users.
•
System Alert Messages in the last 30 days—SMTP server alert messages categorized by application, and
•
when the error last occurred.
System Health Report—Health and performance of the Junos Space nodes in your Junos Space setup
•
and the processes on these nodes. Staring in Release 15.2R1, the Administration workspace displays
the System Health Report widget.
For more information about these widgets, refer to the Viewing the Administration Statistics topic in the
Junos Space Network Management Platform Workspaces Feature Guide.
Release History Table
DescriptionRelease
15.1R2
Staring in Release 15.2R1, the Administration workspace displays the System Health
Report widget.
RELATED DOCUMENTATION
Overall System Condition and Fabric Load History Overview | 6
Junos Space Debug Utilities Overview | 33
13
2
PART
Log Files and Debug Utilities
Troubleshooting Junos Space Network Management Platform Issues by Using Log
Files | 15
Troubleshooting Network Devices by Using Junos Space Debug Utilties | 33
CHAPTER 2
Troubleshooting Junos Space Network Management
Platform Issues by Using Log Files
IN THIS CHAPTER
System Status Log File Overview | 15
Junos Space Network Management Platform Log Files Overview | 17
Troubleshooting Log File Overview | 21
Downloading the Troubleshooting Log File in Server Mode | 22
Downloading the Troubleshooting Log File in Maintenance Mode | 25
Downloading Troubleshooting System Log Files Through the Junos Space CLI | 26
15
Customizing Node System Status Log Checking | 31
Customizing Node Log Files to Download | 32
System Status Log File Overview
The system writes a system log file for each fabric node to provide troubleshooting and monitoring
information. See “System Status Log File” on page 15.
The System Administrator can customize the information that is collected in the system log file. See
“Customizing Node System Status Log Checking” on page 31.
The System Administrator can download the latest log files for each fabric node when logged in to a Junos
Space Appliance. See “Downloading System Log Files for a Junos Space Appliance” on page 16.
In each operating mode, the System Administrator can customize the default log files that are downloaded
from a Junos Space Appliance. See “Customizing Node Log Files to Download” on page 32.
System Status Log File
Approximately once a minute, the system checks and writes a status log file SystemStatusLog for each
fabric node by default. Each log file consists of system status, such as the disk, CPU, and memory usage
information, as shown. Junos Space Network Management Platform writes each system status log file to
The System Administrator can customize the information that is written in a fabric node system status log
file. For more information, see “Customizing Node System Status Log Checking” on page 31.
Downloading System Log Files for a Junos Space Appliance
The System Administrator can download the latest log files for each fabric node when logged in to a Junos
Space Appliance. The system status log file and all other third-party log files are collected and compressed
in a troubleshooting file.
16
Table 3 on page 16 lists the files included in the troubleshoot file.
Table 3: Log Files included in the troubleshoot File
LocationDescription
/var/log/SystemStatusLogSystem status log files
/var/log/jboss/*JBoss log files
/var/tmp/jboss/debug/*Service-provisioning data files
/var/log/mysqld.logMySQL error log files
/var/log/httpd/*Log files for Apache, Node Management Agent (NMA), and
Webproxy
/var/log/watchdog/*Watchdog log files
/var/log/messages/*System messages
The System Administrator can download log files in each operation mode as follows:
Server mode (See “Downloading the Troubleshooting Log File in Server Mode” on page 22.)
•
Maintenance mode (See “Downloading the Troubleshooting Log File in Maintenance Mode” on page 25.)
•
Loading...
+ 63 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.