Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    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 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 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 event scripts in the AI-Scripts bundle are installed in the /var/db/scripts folder of the device.
    5. Committing the event scripts on the device—The event scripts 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 event scripts that are triggered to collect diagnostic and troubleshooting information are installed at this location. The event scripts are named after the log message that would trigger 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.

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

    Modified: 2017-06-08