Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

AI-Scripts and JMBs Overview

 

Advanced Insight-Scripts (AI-Scripts) are Extensible Stylesheet Language Transformations (XSLT), Stylesheet Language Alternative Syntax (SLAX), or XML scripts that provide intelligence to devices to automatically detect and report hardware and software failures or other functional abnormalities to network operators so as to ensure maximum network uptime. AI-Scripts are created by experts in Juniper Networks Technical Assistance Center (JTAC) based on the collective experience on troubleshooting devices running Junos OS.

AI-Scripts are imported into Service Now and installed on the devices in the form of AI-Scripts bundles. AI-Scripts bundles contain scripts for individual events. When a particular event occurs, the script for the event in the AI-Scripts bundle is triggered to generate a Juniper Message Bundle (JMB).

A JMB is an XML file containing device information, trend data, system log files, request support information (RSI), and output of Junos OS commands that are executed to obtain information required for troubleshooting the event. A JMB can be an event JMB (eJMB) or informational JMB ( iJMB) and contains some or all of the following sections—the Manifest, Trend Data, Attachments, and Logs. For more information about types of JMBs and contents of JMBs, see Types of JMBs and Contents of a JMB.

AI-Scripts on a Device

The installation of AI-Scripts on a device by using Service Now involves the following steps:

  1. Connecting to the device—Service Now uses the NETCONF or Device Management Interface (DMI) channel established while discovering the device to connect with the device.
  2. Copying the AI-scripts bundle to the device—Service Now copies the AI-Scripts bundle to the /var/tmp folder of the device.
  3. Committing the configuration—Service Now commits the juniper-groups-ais configuration on the device.
  4. Installing the AI-Scripts bundle on the device—The files in an AI-Scripts bundle are installed in the /var/db/scripts folder of the device.
  5. Committing the event scripts on the device—The files are committed on the device.

On a device running Junos OS, the scripts in the AI-Scripts bundle are installed at the following locations:

  • /var/db/scripts/commit—Among other commit scripts that are installed from the AI-Scripts bundle, the jais-SN-activate-scripts.slax and jais-activate-scripts.slax scripts are installed at this location.

    • The jais-SN-activate-scripts.slax script is added by Service Now. This file contains a list of events that are relevant to the device and the events that are selected by the user while configuring the event profile.

    • The jais-activate-scripts.slax script contains a list of all event scripts in the AI-Scripts bundle and is mainly used for testing purposes.

  • /var/db/scripts/event—The scripts that are triggered to collect diagnostic and troubleshooting information are installed at this location. The scripts are named after the log message that triggers the script. For example, the AV_PATTERN_BIG .slax file is triggered when the AV_PATTERN_BIG message is logged in the system logs of the device.

    The intelligence-event-main.slax script to generate iJMBs is also installed here.

  • /var/db/scripts/op—Among other scripts, the following scripts are installed at this location from the AI-Scripts bundle:

    • on-demand.slax script: This script is invoked to generate on-demand JMBs.

    • remove-jais.slax script: This file helps in the uninstallation and removal of all files from the AI-Scripts bundle installed on the device.

    • ais-param-set.slax script: This file contains configuration parameters such as parameters to enable or disable BIOS and request support information (RSI) collection, parameters to define Service Now and Junos Space release to be included in a JMB, and parameters to define an interval to collect BIOS data and generate RSI.

    • ais-health-report.slax script: For AI-Scripts Release 4.1R7 and later, this script is used to generate a JMB that provides an insight into the operation of AI-Scripts.

    • stop-ais-now.slax script: For AI-Scripts Release 4.1R7 and later, this script is used to temporarily disable JMB generation on a device (for example, while upgrading Junos OS).

    • ais_event_sim.sh: This script is used to monitor the behavior of AI-Scripts installed on a device. When you execute this script, an error message is logged in the system log of the device triggering an event script from the AI-Scripts bundle to execute and generate a JMB.

      For more information about monitoring AI-Scripts behavior, see Monitoring AI-Scripts Behavior by Using the AI-Scripts Event Simulator.

For information about all the files included in an AI-Scripts bundle, see Contents of an AI-Scripts Package in the AI-Scripts Feature Guide.

Refer to the Service Automation User Guide Addenda - Master List for details about the installation of AI-Scripts on specific platforms.