Advanced Insight Scripts (AI-Scripts) Frequently Asked ...

1 Advanced Insight Scripts (AI- Scripts ) Frequently Asked Questions19 December 2008 Part Number: 530 028434-01 Revision 1 This document provides answers to Frequently Asked questions about the AdvancedInsight Scripts (AI- Scripts ), JUNOS event Scripts used to enable automatic detectionand packaging of reactive events and proactive intelligence information on JuniperNetworks J-series, M-series, MX-series, T-series, EX-series, and SRX-series routingplatforms to ensure maximum are a basic component of Advanced Insight Solutions (AIS), a JuniperNetworks J-Care Technical Services product that provides several levels of technicalsupport for devices on the network. AI- Scripts send reactive events and proactiveintelligence information (eJMBs and iJMBs) to archive locations from which AdvancedInsight Manager (AIM), a gateway application, detects them and provides a userinterface to monitor them to open cases for resolution and to receive key knowledgebased information from Juniper Support Systems (JSS) more detailed information about AI- Scripts , see the AIS User Guide and theAI- Scripts Release NotesAI- Scripts Release Notes located at What are AI- Scripts ?

2 4Q. What do AI- Scripts do?..4Q. What is the AI- Scripts data flow?..4Q. What is inside a JMB?..5Q. What are the two AI- Scripts operation modes?..5Q. What events are detected by AI- Scripts in a release?..5Q. How often are AI- Scripts packages released?..5Q. What metrics are collected by AI- Scripts for intelligence informationsent to AIM?..5Q. What Scripts are included in an AI- Scripts release?..6 1Q. How do AI- Scripts detect events in JUNOS?..6Q. Can AI- Scripts detect potential hardware failures (for example, RoutingEngine or hard disk)?..6Q. Can you see the information that is contained in the eJMB andiJMB?..6Q. Is it possible to review the historical data (JMBs and iJMBs) sent toJuniper Networks by AIM?..6Q. Can AI- Scripts detect network-level incidents such as protocol flaps,routing loops, or traffic blackholes?..6Q. Can AI- Scripts detect interface-level problems such as packetsdrops?..6Q. Can you selectively disable some AI- Scripts , to avoid receivingincidents detected by those Scripts ?

3 6Q. How does Juniper Networks determine which incidents will beincluded in future AI- Scripts releases?..7Q. Is there any other way for AIS to collect information from devicesbesides AI- Scripts ?..7 Juniper Message Bundles (JMBs)..7Q. What is a Juniper Message Bundle (JMB)?..7Q. What is an incident-based JMB (eJMB)?..7Q. What is an intelligence-based JMB (iJMB)?..7Q. What types of events trigger eJMBs?..7Q. What communication protocols are used to transfer JMBs betweenJUNOS devices and AIM?..8Q. How Frequently do devices report iJMBs to AIM?..8Q. Is it possible to configure the frequency of the data collection for theiJMB?..8Q. What information is collected by the intelligence AI- Scripts into theintelligence iJMB?..8Q. How big is a JMB?..8Q. How big is an iJMB?.. How do AI- Scripts affect JUNOS system resource utilization?..8 Installing What are the AI- Scripts installation system requirements?..9Q. What versions of JUNOS does an AI- script installation packagesupport?

4 9Q. When do you install AI- Scripts in the AIS setup?..9Q. How can you install AI- Scripts ?..9Q. How are AI- Scripts versioned?..9Q. From where do you download AI- script installation packages?..10Q. Where do you move AI- script installation packages on thedevice?..10Q. Where are AI- Scripts installed on a device?..10 Automatic AI- Scripts Installation Using JUNOS cope or Later Softwareand How do you install AI- Scripts automatically using JUNOS copesoftware?..11Q. Does AIM need JUNOS cope?..112 Advanced Insight Scripts (AI- Scripts ) Frequently Asked QuestionsManual AI- Scripts What are the AI- Scripts installation Quick Steps?..11Q. How do I configure AI- Scripts to run on a device?..11Q. On a router with dual Routing Engines, should AI- Scripts be installedon both Routing Engines?..13Q. How do you verify that AI- Scripts are activated?..14Q. After installing AI- Scripts , how do you test the JMB flow from thenetwork device to AIM?..14Q. How soon after AI- Scripts installation is a intelligence iJMBgenerated?

5 15Q. How can you tell what version of AI- Scripts is installed on adevice?..15 Upgrading How do I ensure that my AI- script bundles are updated?..15Q. How do you upgrade AI- Scripts ?..15Q. Does AI- Scripts or AIM have to be upgraded when you upgradeJUNOS?..16Q. Do you have to upgrade JUNOS software whenever AI- Scripts isupgrade the ?..16Q. Do you have to upgrade AIM software whenever AI- Scripts isupgraded?..16AI- Scripts How do you install an AI- script on a device?..16Q. How do you delete an AI- script from a device?..16Q. How do you roll back an AI- script on a device?..16Q. How do you not save a copy of AI- Scripts package files duringinstallation?..17Q. How do you remove an AI- script installation package afterinstallation?..17 3AI- Scripts OverviewQ. What are AI- Scripts ?AI- Scripts are specialized Juniper Networks operational and event Scripts that detectevents and provide information for analysis, to periodically collect intelligenceinformation, and to package all incident and intelligence event data into a structuredformat called a Juniper Message Bundle (JMB) and send it to a remote archive locationso that it can be collected and displayed by Advanced Insight Manager (AIM).

6 AI-Scriptsare written in XSLT and are bundled, signed, and packaged like other JUNOS softwarebundles. AI- script bundles are downloaded from the Juniper Networks softwaredownload Web site, and are installed on Juniper Networks routing platforms (devices)running JUNOS Release or can be configured to send event data to Juniper Support Systems (JSS), the thirdcomponent in the AIS system. JSS collects incident and intelligence information fromAIM and sends intelligence information back to AIM specifically for your What do AI- Scripts do?AI- Scripts : React to specific incident events that occur on devices and provide relevantinformation about the problems for analysis Periodically collect data on events that can be used to predict and prevent risksin the future. Package all incident and intelligence event data into a structured format calleda Juniper Message Bundle (JMB) and send it to a remote archive location so thatit can be collected and displayed by the second component in the AIS system, Advanced Insight Manager (AIM) gateway What is the AI- Scripts data flow?

7 Installed on Juniper Networks devices detect events or analyze event and intelligence package and send a JMB to an archive location (either a local directoryon the same system as AIM or a directory mounted from another system ontothe system running AIM). connects to the AIM archive location, retrieves, then displays the JMBinformation in Incident Manager for reactive services and Intelligence Managerfor proactive services. For reactive services, AIM submits a case for resolutionby JSS. For proactive services, JSS analyzes intelligence information, then sendsAIM pertinent information to prevent problem events from occurring in AI- Scripts OverviewAdvanced Insight Scripts (AI- Scripts ) Frequently Asked QuestionsQ. What is inside a JMB? Manifest basic router and event data Trend data device counters, statistics, and settings Attachments show command output for the incident eventQ. What are the two AI- Scripts operation modes? Reactive (incident-driven) A trigger event occurs and is detected on a AI- script is executed.

8 An AI- script builds a Juniper Message Bundle (JMB) withevent and router data, and sends it to a designated AIM archive AI- script corresponds to a specific device event. The list of device eventsthat can be detected and reported will evolve over time. For the latest deviceevents supported by AI- Scripts , see the AI- Scripts Release Notes located Proactive (intelligence-driven) AI- Scripts monitor device system resources forfluctuations that could signal a future problem. AI- Scripts collect intelligence datafor analysis. A tailored AI- script builds a JMB with intelligence data, and sendsit to a designated remote AIM archive What events are detected by AI- Scripts in a release? Common software events, including daemon and Packet Forwarding Enginecrashes Common hardware events, such as PIC alarms Hardware platform-specific events, such ASIC issues Errors resulting from resource congestionFor a complete list of the AI- Scripts added and the events detected, see the AI-ScriptsRelease Notes located at How often are AI- Scripts packages released?

9 Juniper Networks release AI- Scripts twice a What metrics are collected by AI- Scripts for intelligence information sent to AIM? System buffers (show system buffers) System processes (show system processes extensive) Memory-related metrics (show heap, show jtree 0 memory, show task memory)For a complete list, consult Juniper Support Systems at http:/juniper/support/.AI- Scripts Overview 5AI- Scripts OverviewQ. What Scripts are included in an AI- Scripts release?For a complete list of the AI- Scripts added and the events detected, see the AI-ScriptsRelease Notes located at How do AI- Scripts detect events in JUNOS?AI- Scripts event Scripts are activated and stored in a table in the eventd process. Theeventd process monitors all of the log messages generated by all system eventd detects an event script event trigger, it executes the associated Can AI- Scripts detect potential hardware failures (for example, Routing Engine or harddisk)?Yes, but it also depends on the failure.

10 If the failure is one of the problems that theAI- Scripts supports for that release, then it will be Can you see the information that is contained in the eJMB and iJMB?Yes. You can view eJMBs in AIM Incident Manager and iJMBs in AIM IntelligenceManager. For more information about AIM Incident and Intelligence Managers, seethe AIS User Guide located at Is it possible to review the historical data (JMBs and iJMBs) sent to Juniper Networksby AIM?Yes. View the historical data can be viewed in AIM Incident Manager and IntelligenceManager. For more information about AIM Incident Manager and Intelligence Manager,see the AIS User Guide located at Can AI- Scripts detect network-level incidents such as protocol flaps, routing loops, ortraffic blackholes?It depends on the event. If there are trigger-points, indicators such as log messages,it can but if traffic is lost silently, it Can AI- Scripts detect interface-level problems such as packets drops?No, AI- Scripts cannot detect interface problems, and it cannot be triggered off suchactivities, but AI- Scripts can collect such values and make decisions based on Can you selectively disable some AI- Scripts , to avoid receiving incidents detected bythose Scripts ?