Juniper ADVANCED INSIGHT SCRIPTS 2.5 - S REV 1 Release note
โฆษณา
โฆษณา
ADVANCED INSIGHT SCRIPTS (AI-SCRIPTS)
3.0 RELEASE NOTES
1 August 2011
Revision 1
These release notes accompany Release 3.0R2 of the Advanced Insight Scripts (AI-Scripts).
AI-Scripts are Junos OS event scripts used to enable Juniper Networks J Series, M Series, MX
Series, T Series, EX Series, Data Center Class SRX Series, and QFX Series devices to:
§ React to specific incident events that occur and provide relevant information for analysis
§ Periodically collect data on events that can be used to predict and prevent risks in the future
§ Package all incident and intelligence event data into a structured format, such as a Juniper
Message Bundle (JMB), and send it to an archive location to be collected and displayed by the Service Now / Junos Space
You can also find these release notes, the Advanced Insight Scripts (AI-Scripts) Release Notes, and the AIS User Guide on the Juniper Networks Technical Publications webpage at http://www.juniper.net/techpubs/software/management/ais/ .
Contents
Copyright
©
2011, Juniper Networks, Inc.
1
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
2
Copyright
©
2011, Juniper Networks, Inc.
Summary of Release 3.0 Features
Summary of Release 3.0 Features
This section describes key features of the current AI-Scripts release.
AI-Scripts 3.0R2
Features
§ AI-Scripts MIB2D event-scripts dampening interval increased to 24 hours. (PR 576295)
§ AI-Script PIC crash event-script added for platforms that do not generate a PFE crash event under the PFE psuedo-ID. (PR 669808)
§ AI-Script added for PFE:.*RSMON: Resource Category:jtree Instance.*less than LWM limit.* entry. (PR 672541)
Bugs
§ Some AI-Scripts event-scripts attachments for collecting syslog messaages on PFE boards are invalid. (PR 663104)
§ AI-Scripts attachments for I-chip-related events had malformed command statements. (PR
663439)
§ AI-Scripts not working on MX80-48t platform. (PR 669226)
AI-Scripts 3.0R1
Features
§ AI-Scripts code modified to use jcs:execute Junoscript call in place of jcs:invoke to spawn fewer mgd sessions. (PR 599342)
§ AI-Scripts feature added to installer (commit-script) to only activate event-scripts that are relevant to the low-end SRX and EX Series platforms. (PR 601255)
§ AI-Scripts change to add jcs:dampen Junoscript call to lessen system impact of Junos OS bug with event-script dampening via ignore policy (sw-ui-misc/505359). (PR 601259)
§ AI-Scripts event-script ignore policies added back in for all events. Ignore polices were removed with implementation of PR/601259, but dampen function proved inadequate. (PR
612575)
§ Modify the existing AI-Scripts syslog message that is generated when a new JMB is created and the permissions have been changed by the ais_change_perm.slax op script. (PR
612884)
§ Last phase of AI-Scripts events-scripts conversion to new dampening methods for eventscripts with no attributes or no attachments. (PR 659155)
§ AI-Scripts commit-script modified to allow intelligence-script to run on low-end EX and SRX
Series platforms, whose platform-specific script activation tags are not read by Service Now version 11.1. (PR 659644)
Bugs
§ AI-Scripts commit-script (jais-activate-scripts.slax) modified to check existence of script files in /jais packages mount before activating event-scripts. (PR 594194)
Copyright
©
2011, Juniper Networks, Inc.
3
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
§ The 11.2R1 Script bundle of AI-scripts will not generate a JMB for EX and SRX Series devices. It will however still generate eJMB files. (PR 614102)
AI-Scripts Operation
AI-Script Modes
AI-Scripts do the following tasks:
§ React to specific incident events that occur on devices and provide relevant information about the problems for analysis
§ Periodically collect data on events that can be used to predict and prevent risks in the future
§ Package all incident and intelligence event data into a structured format, such as a Juniper
Message Bundle (JMB), and send it to a remote archive location so that it can be collected and displayed by Service Now
AI-Scripts operate in two distinct modes:
§ Reactive (incident-driven)—A trigger event occurs and is detected on a device. An AI-Script is executed. An AI-Script builds a Juniper Message Bundle (JMB) with event and router data, and sends it to a designated Service Now archive location.
Each AI-Script corresponds to a specific device event. The list of device problem events that can be detected and reported will evolve over time. See Table 1 on page 3.
§ Proactive (intelligence-driven)—AI-Scripts monitor device system resources for fluctuations that could signal a future problem. AI-Scripts collect intelligence data for analysis. A tailored
AI-Script builds a JMB with intelligence data and sends it to a designated remote Service
Now archive location.
4
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Events Detected by AI-Scripts
Table 1 lists the events detected by Release 3.0 of AI-Scripts.
Table 1: Events Detected by AI-Scripts
EVENT ID
ACCT_MALLOC_FAILURE
ACCT_XFER_POPEN_FAIL
ASP_IDS_INV_CLEAR_QUERY
ASP_IDS_INV_CLEAR_QUERY_VER
ASP_L2TP_NO_MEM
ASP_L2TP_OBJ_CAC_FAIL
ASP_PGCP_IPC_PIPE_WRITE_FAILED
ASP_PGCP_IPC_PIPE_WRITE_FAILED
AUDITD_RADIUS_OPEN_FAILED
AUDITD_RADIUS_OPEN_FAILED
AUDITD_RADIUS_REQ_CREATE_FAILED
AUDITD_SOCKET_FAILURE
AUTHD_AUTH_CREATE_FAILED
AUTHD_SERVER_INIT_BIND_FAIL
DESCRIPTION
The accounting statistics process could not allocate memory from the heap.
A failed call to the popen() function when the accounting statistics process invokes the indicated command to transfer the indicated file.
The intrusion detection services (IDS) receives a request to clear information from the IDS tables. The request includes the indicated type of query, which the IDS cannot interpret.
The intrusion detection services (IDS) receives a request to clear information from the IDS tables. The request version number did not match the version number of requests that the IDS can service.
The Layer 2 Tunneling Protocol (L2TP) could not allocate the memory it needed to create a flow for the indicated tunnel and session.
The Layer 2 Tunneling Protocol (L2TP) could not allocate memory from an object cache for the flow defined by the indicated unit, tunnel, and session.
The Packet Gateway Control Protocol (PGCP) client on the Services Port
Interface Card failed to write an inter-process communication (IPC) message to the end of its pipe.
The Packet Gateway Control Protocol (PGCP) client on the Services Port
Interface Card failed to write the contents of its inter-process communication (IPC) pipe to the socket layer.
The audit process (auditd) could not create a RADIUS object handle used for various RADIUS operations.
The audit process (auditd) could not create a RADIUS object handle used for various RADIUS operations.
The audit process (auditd) could not create a RADIUS accounting request for the indicated reason.
The audit process (auditd) listens on a Transmission Control Protocol
(TCP) socket for system accounting events reported by other processes on the device. The indicated socket operation failed with the indicated error.
The generic authentication service process (authd) could not allocate an authentication object for the indicated reason.
The generic authentication service process (authd) could not bind the server to the address specified.
Copyright
©
2011, Juniper Networks, Inc.
5
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
AUTHD_SERVER_INIT_LISTEN_FAIL
DESCRIPTION
The generic authentication service process (authd) could not initialize listening on the server for the indicated socket.
AUTHD_SETSOCKOPT_FAILED The generic authentication service process (authd) could not set socket options during the indicated operation.
AUTHD_SOCKET_FAILED
AUTOCONFD_AUTH_NO_MEM
AUTOD_RECV_FAILURE
AUTOD_SEND_FAILURE
AUTOD_SOCKET_CREATE_FAILURE
AV_PATTERN_KL_CHECK_FAILED
AV_PATTERN_TOO_BIG
AV_PATTERN_WRITE_FS_FAILED
BFDD_READ_ERROR
BFDD_WRITE_ERROR
BOOTPD_HWDB_ERROR
CFMD_RTSOCK_OPEN_FAILURE
CHASSISD_BUS_DEVICE_OPEN_FAILURE
CHASSISD_CFEB_POWER_FAILURE
CHASSISD_CLOCK_FAILURE
CHASSISD_CMB_READBACK_ERROR
The generic authentication service process (authd) could not open a socket during the indicated operation.
The memory allocation (malloc) for username authentication failed.
The autoinstallation process (autod) received the indicated error when it tried to receive data on a socket.
The autoinstallation process (autod) receives the indicated error when it sends data on a socket.
The autoinstallation process (autod) receives the indicated error when it creates a socket.
The device is unable to use the Kaspersky pattern file. The error message provides information to give to Juniper Networks technical support.
The pattern file size specified in the server initialization file (server.ini) exceeds the maximum prescribed limit.
The device is unable to save the contents of an antivirus pattern file to the file system.
The bidirectional forwarding detection process (bfdd) could not read a message available on the indicated type of pipe.
The bidirectional forwarding detection process (bfdd) could not write a message to the indicated type of pipe.
The boot parameter process (tnp.bootpd) could not complete an operation in the hardware database maintained by the chassis process (chassisd), for the indicated reason.
The connectivity fault management process (cfmd) could not successfully open a routing socket to the kernel, for the indicated reason.
The chassis process (chassisd) could not open the indicated bus device, for the indicated reason.
The chassis process (chassisd) could not turn on or turn off the power to the indicated Compact Forwarding Engine Board (CFEB).
The chassis process (chassisd) determined that the indicated clock source failed in the indicated way.
The chassis process (chassisd) could not read back information from the
Chassis Management Bus (CMB) about the indicated component (fieldreplaceable unit, or FRU).
6
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
CHASSISD_COMMAND_ACK_ERROR
DESCRIPTION
The chassis process requested that the indicated component (fieldreplaceable unit, or FRU) confirm that it was online. The indicated error occurred when the FRU sent its response. In the normal case, the chassis process performed any additional action necessary to guarantee that the
FRU came online.
CHASSISD_COMMAND_ACK_SFM_ERROR
CHASSISD_FAN_FAILURE
CHASSISD_FASIC_FTOKEN_ERROR
CHASSISD_FASIC_FTOKEN_INIT_ERROR
The chassis process (chassisd) requires an acknowledgment from each
Switching and Forwarding Module (SFM) before it registers a Flexible PIC
Controller (FPC) as online. The acknowledgment message from the indicated SFM failed for the indicated FPC.
The indicated fan or impeller failed. The chassis process (chassisd) raised an alarm and increased the speed of the remaining fans (and impellers, if applicable) to full speed.
The chassis process (chassisd) detected an underflow or overflow error on the indicated F chip on the indicated Control Board (CB).
The chassis process (chassisd) encountered an error while initializing memory at the indicated address for the indicated F chip on the indicated
Control Board (CB).
CHASSISD_FASIC_HSL_CONFIG_ERROR
CHASSISD_FASIC_HSL_LINK_ERROR
CHASSISD_FASIC_INIT_ERROR
CHASSISD_FASIC_INPUT_DROP
CHASSISD_FASIC_OUTPUT_DROP
CHASSISD_FASIC_PIO_READ_ERROR
The chassis process (chassisd) could not configure high-speed links (HSL) for the indicated F chip on the indicated Control Board (CB).
The chassis process (chassisd) detected an error for the indicated highspeed link (HSL) for the indicated F chip on the indicated Control Board
(CB).
The chassis process (chassisd) detected that F chips were not yet initialized on the Control Board (CB).
The Packet Forwarding Engine divides packets into smaller units called cells for more efficient processing. As the indicated F chip on the indicated
Control Board (CB) processed data that was received from the indicated
Packet Forwarding Engine on the indicated Flexible PIC Concentrator
(FPC), it dropped the indicated number of cells per second.
The Packet Forwarding Engine divides packets into smaller units called cells for more efficient processing. As the indicated F chip on the indicated
Control Board (CB) processed data before sending it to the indicated
Packet Forwarding Engine on the indicated Flexible Port Concentrator
(FPC) for outgoing transmission, it dropped the indicated number of cells per second.
The indicated routine failed with a read error at the indicated address and register for the indicated F chip and link on the indicated Control Board
(CB).
Copyright
©
2011, Juniper Networks, Inc.
7
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
CHASSISD_FASIC_PIO_WRITE_ERROR
DESCRIPTION
The indicated routine failed with a write error at the indicated address and register for the indicated F chip and link on the indicated Control Board
(CB).
CHASSISD_FASIC_PLL_ERROR The chassis process (chassisd) could not lock a phased-lock loop (PLL) for the indicated F chip on the indicated Control Board (CB).
CHASSISD_FASIC_RESET_ERROR
CHASSISD_FASIC_SRAM_ERROR
CHASSISD_FCHIP_CONFIG_MD_ERROR
CHASSISD_FCHIP_HSR_ERROR
CHASSISD_FCHIP_HST_ERROR
CHASSISD_FCHIP_LINK_ERROR
CHASSISD_FCHIP_MONITOR_ERROR
CHASSISD_FCHIP_PIO_READ_ERROR
CHASSISD_FCHIP_PIO_WRITE_ERROR
CHASSISD_FHSR_READ_REG_ERROR
CHASSISD_FHSR_WRITE_REG_ERROR
CHASSISD_FHST_READ_REG_ERROR
CHASSISD_FHST_WRITE_REG_ERROR
CHASSISD_FILE_OPEN
The chassis process (chassisd) could not reset the indicated F chip on the indicated Control Board (CB).
The chassis process (chassisd) detected that SRAM failed to initialize for the indicated F chip on the indicated Control Board (CB).
The chassis process (chassisd) detected an invalid number of Md chips for the indicated F chip, Packet Forwarding Engine, and Flexible PIC
Concentrator (FPC).
The chassis process (chassisd) detected an error in the high-speed receiver (HSR) subsystem for the F chip with the indicated characteristics.
The chassis process (chassisd) detected an error in the high-speed transmitter (HST) subsystem for the F chip with the indicated characteristics.
The chassis process (chassisd) detected an error for the indicated highspeed receiver (HSR) or high-speed transmitter (HST) link for an F chip on the indicated Switch Interface Board (SIB).
The chassis process (chassisd) detected an invalid F-chip module while enabling or disabling the monitoring of F-chip functional blocks.
The indicated routine failed with a read error at the indicated address and register for the indicated F chip and link.
The indicated routine failed with a write error at the indicated address and register for the indicated F chip and link.
The high-speed receiver (HSR) read routine failed at the indicated address on an F-chip register.
The high-speed receiver (HSR) write routine could not record the indicated value at the indicated address on an F-chip register.
The high-speed transmitter (HST) read routine failed at the indicated address on an F-chip register.
The high-speed transmitter (HST) write routine could not record the indicated value at the indicated address on an F-chip register.
The chassis process (chassisd) could not open the indicated file for the indicated reason.
8
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
CHASSISD_FM_ERROR
DESCRIPTION
During execution of the indicated fabric management routine, the indicated error occurred between the indicated Switch Interface Board (SIB) and the indicated Packet Forwarding Engine on the indicated Flexible PIC
Concentrator (FPC).
CHASSISD_FM_ERROR_SIB_L_FB_HSR
CHASSISD_FM_ERROR_SIB_L_FB_SMF
CHASSISD_FM_ERROR_SIB_S_FB_HSR
CHASSISD_FM_ERROR_SIB_S_FB_SMF
CHASSISD_FM_SIB_ERROR
CHASSISD_FPC_PIC_DETECT_TIMEOUT
CHASSISD_FRU_INVALID_SLOT
CHASSISD_GBUS_NOT_READY
In a routing matrix, packets traverse both electrical and optical media as they travel between the Switch Interface Boards (SIBs) in the T640 router
(called SIB-Ls) and the SIBs in the TX Matrix platform (called SIB-Ss). The chassis process (chassisd) on the routing node that houses the indicated
SIB-L detected an error in the electrical path between the indicated ports on the SIB-L and the corresponding SIB-S.
In a routing matrix, packets traverse both electrical and optical media as they travel between the Switch Interface Boards (SIBs) in the TX Matrix
(the switch-card chassis, or SCC) and the SIBs in the T640 routers (called
SIB-Ls). The chassis process (chassisd) on the T640 router that houses the indicated SIB-L detected the indicated error as packets that were traveling in the indicated direction were translated between electrical and optical media.
In a routing matrix, packets traverse both electrical and optical media as they travel between the Switch Interface Boards (SIBs) in the TX Matrix platform (called SIB-Ss) and the SIBs in the T640 routers (called SIB-Ls).
The chassis process (chassisd) on the TX Matrix detected an error in the electrical path between the indicated port on the indicated SIB-S and the indicated port on a SIB-L installed in the indicated T640 router (line-card chassis, or LCC).
In a routing matrix, packets traverse both electrical and optical media as they travel between the Switch Interface Boards (SIBs) in the TX Matrix
(called SIB-Ss) and the SIBs in the T640 routers (line-card chassis, or
LCCs). The chassis process (chassisd) on the TX Matrix platform detected the indicated error as packets that were traveling to or from the indicated
LCC were translated between electrical and optical media.
The chassis process (chassisd) detected the indicated type of error on the indicated Switch Interface Board (SIB) and performed the indicated action.
The chassis process (chassisd) expects to receive notification within a timeout period that each Flexible PIC Concentrator (FPC) has attached the
PIC that it houses. It did not receive notification from the indicated FPC.
The chassis process (chassisd) detected that the indicated hardware component (field-replaceable unit, or FRU) was inserted in a slot that is not valid for that component type.
The GBUS was not ready when the chassis process (chassisd) first tried to power it on, and the power-up operation timed out.
Copyright
©
2011, Juniper Networks, Inc.
9
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
CHASSISD_GBUS_READBACK_ERROR
DESCRIPTION
There was an error when the chassis process (chassisd) tried to read back information from the GBUS on the indicated component (field-replaceable unit, or FRU).
CHASSISD_HSR_FIFO_ERROR A first-in, first-out (FIFO) read error occurred during execution of the indicated routine on the indicated high-speed receiver (HSR).
CHASSISD_I2C_BAD_IDEEPROM_FORMAT
CHASSISD_I2C_READ_ERROR
CHASSISD_I2CS_READBACK_ERROR
CHASSISD_IFDEV_DETACH_FPC
CHASSISD_IFDEV_DETACH_PIC
CHASSISD_IPC_CONNECTION_DROPPED
CHASSISD_IPC_DAEMON_WRITE_ERROR
CHASSISD_IPC_MSG_DROPPED
CHASSISD_IPC_MSG_UNHANDLED
CHASSISD_IPC_WRITE_ERR_NULL_ARGS
CHASSISD_MAC_ADDRESS_ERR
CHASSISD_MAC_ADDRESS_FABRIC_ERR
The chassis process (chassisd) determined that the ID EEPROM format specified for the indicated type of hardware component (field-replaceable unit, or FRU) is not valid for it.
The chassis process (chassisd) cannot read I2C data from the indicated device.
The chassis process (chassisd) cannot read back information from the I2C slave (I2CS) about the indicated component (field-replaceable unit, or
FRU).
The chassis process (chassisd) detached the interface devices for all PICs on the indicated Flexible PIC Concentrator (FPC).
The chassis process (chassisd) detached the interface devices for the indicated PIC.
The chassis process (chassisd) dropped the interprocess communication
(IPC) connection to the indicated component (field-replaceable unit, or
FRU).
The chassis process (chassisd) could not write to a socket because of the indicated error. The socket is for a connection to another process that runs on the Routing Engine and helps manage the chassis.
The chassis process (chassisd) dropped an interprocess communication
(IPC) message because the message queue had already reached maximum capacity.
The chassis process (chassisd) received an interprocess communication
(IPC) message about the indicated FRU. The message had the indicated characteristics. chassisd could not handle the message.
The chassis process (chassisd) could not send a message to the indicated component (field-replaceable unit, or FRU) because one or more required parameters had a null value.
The chassis process (chassisd) could not obtain a media access control
(MAC) address for the indicated interface because of an internal error.
The chassis process (chassisd) could not obtain a media access control
(MAC) address for the indicated fabric interface because of an internal error.
10
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
CHASSISD_MALLOC_FAILURE
DESCRIPTION
The chassis process (chassisd) could not allocate memory. chassisd tried to continue functioning, but the lack of memory usually causes the process to fail. An administrator needs to restart it.
CHASSISD_MBE_DETECTED A multibit ECC parity error was detected in the Routing Engine DRAM.
CHASSISD_OVER_TEMP_CONDITION
CHASSISD_OVER_TEMP_SHUTDOWN_TIME
CHASSISD_PEM_OVERLOAD
CHASSISD_PEM_VOLTAGE
CHASSISD_PIC_HWERROR
CHASSISD_POWER_CONDITION
CHASSISD_PSU_ERROR
CHASSISD_PSU_FAN_FAIL
CHASSISD_PSU_INPUT_BAD
CHASSISD_PSU_OVERLOAD
CHASSISD_PSU_TEMPERATURE
CHASSISD_PSU_VOLTAGE
CHASSISD_RE_OVER_TEMP_CONDITION
The temperature of one or more components (field-replaceable units, or
FRUs) exceeded the indicated temperature, which is the upper of two thresholds. The fans (and impellers, if applicable) were in the indicated state. If the temperature does not go below the threshold within four minutes after the chassis process (chassisd) detects this condition, chassisd shuts down the device. When this message was logged, the indicated number of seconds remained before shutdown.
The chassis process (chassisd) shut down the device because the temperature of one or more components exceeded the indicated threshold temperature for the indicated amount of time. Continued operation at the excessive temperature could damage the device.
The indicated power entry module (PEM) reported an output voltage overload condition.
The indicated power entry module (PEM) reported a problem with its output voltage.
The indicated PIC experienced a hardware error. The chassis process
(chassisd) did not bring the PIC online.
The temperature of the indicated Routing Engine exceeded the indicated temperature, which is the upper of two thresholds.
The chassis process (chassisd) detected the indicated error condition for the indicated power supply unit (PSU).
The PSU fan-fail bit is set in the status for the indicated power supply unit
(PSU).
The chassis process (chassisd) detected the input voltage/warning fault condition for the indicated power supply unit (PSU).
The indicated power supply unit (PSU) reported an output voltage overload condition.
The chassis process (chassisd) detected that the temperature check bit was set in the status bit mask for the indicated power supply unit (PSU).
The indicated power supply unit (PSU) reported a problem with its output voltage.
The temperature of the indicated Routing Engine exceeded the indicated temperature, which is the upper of two thresholds.
Copyright
©
2011, Juniper Networks, Inc.
11
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
CHASSISD_RE_OVER_TEMP_SHUTDOWN
DESCRIPTION
The chassis process (chassisd) performed the indicated action because the temperature of the indicated Routing Engine exceeded the maximum threshold for more than four minutes. Continued operation at the excessive temperature could damage device components.
CHASSISD_RE_OVER_TEMP_WARNING
CHASSISD_SBE_DETECTED
CHASSISD_SIB_INVALID_SLOT
CHASSISD_SMB_INVALID_PS
CHASSISD_SMB_IOCTL_FAILURE
CHASSISD_SMB_READ_FAILURE
CHASSISD_TEMP_SENSOR_FAILURE
CHASSISD_TIMER_VAL_ERR
CHASSISD_UNEXPECTED_EXIT
CHASSISD_VOLTAGE_READ_FAILED
CHASSISD_VOLTAGE_SENSOR_INIT
CONNECTION_CHASSISD_FAIL
CONNECTION_CRAFTD_FAIL
The temperature of the indicated Routing Engine exceeded the indicated temperature, which is the upper of two thresholds. If the temperature does not go below the threshold within four minutes after the chassis process
(chassisd) detects this condition, chassisd shuts down the indicated component. When this message was logged, the indicated number of seconds remained before shutdown.
Too many single-bit correctable ECC parity errors were detected in
Routing Engine DRAM.
The chassis process (chassisd) detected the presence of a Switch
Interface Board (SIB) in an invalid slot. The SIB remains offline.
The chassis process (chassisd) could not set the status (enabled or disabled) for a power supply because it received the indicated power supply status code, which is invalid.
The indicated ioctl() operation failed at the indicated address on the system management bus (SMB).
A read() operation failed at the indicated address on the system management bus (SMB).
The temperature sensor for the indicated component (field-replaceable unit, or FRU) either did not respond to a request from the chassis process
(chassisd) for a temperature reading or sent a value that is outside the normal operating range.
The chassis process (chassisd) started a timer to track the timeout period for an event. The timer returned a null identifier, so chassisd could not clear the timer.
The chassis process (chassisd) exited unexpectedly and reported the indicated error.
The chassis process (chassisd) could not read the voltage data from the indicated component (field-replaceable unit, or FRU).
The chassis process (chassisd) could not initialize the voltage sensor for the indicated component (field-replaceable unit, for FRU).
The alarm process (alarmd) was unable to connect to the chassis process
(chassisd).
The alarm process (alarmd) was unable to connect to the craft process
(craftd).
12
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
CONNECTION_RTLOGD_FAIL
DESCRIPTION
The alarm process (alarmd) was unable to connect to the Juniper
Networks J Series Services Router (JSR) log process (rtlogd).
CONNECTION_SEND_ERROR
COSD_GENCFG_WRITE_FAILED
COSD_MALLOC_FAILED
COSD_RTSOCK_LIB_ERR
COSD_RTSOCK_WRITE_FAILED
COSD_UNEXPECTED_EXIT
COSD_UNKNOWN_TRANSLATION_TABLE
Daemon Crash
DCD_CONFIG_WRITE_FAILED
DCD_GET_ERROR
DCD_PARSE_STATE_EMERGENCY
DCD_RTSOCK_READ_SYNC_NOBUF
DCD_RTSOCK_SEND_NOBUF
DCD_TRASHED_RED_ZONE
The alarm process (alarmd) received an error while it was trying to send a message.
The class-of-service (CoS) process (cosd) uses GENCFG to read and write data from the kernel. If the write fails, the kernel returns an error.
The class-of-service (CoS) process (cosd) could not dynamically allocate memory, for the indicated reason.
The class-of-service (CoS) process (cosd) uses rtsock library for reading and writing data from and to kernel. The specified error occurred while using rtsock library to read/write data.
The class-of-service (CoS) process (cosd) uses rtsock to read/write data from kernel. If the write fails kernel returns an error.
The class-of-service (CoS) process (cosd) waits for the event notifications and processes the events that it is registered for. There was an error during event-handling initialization.
The class-of-service (CoS) process (cosd) did not recognize the indicated translation table type from the rtsock library.
A Junos OS daemon crash occurred with a core dump.
The interface process (dcd) encountered an error while trying to send an interface configuration to the kernel over the routing socket.
The interface process (dcd) encountered an error while trying to load the kernel interface configuration over the routing socket.
The interface process (dcd) encountered an unhandled internal state during interface parsing.
The interface process (dcd) communicates with the kernel by writing messages to and reading messages from routing sockets. The DCD could not allocate memory to use to read messages from the kernel.
If the Routing Engine is busy or operating under a heavy load, messages between the interface process (dcd) and the kernel may be dropped. To detect whether messages have been dropped, dcd and the kernel place sequence numbers in messages. dcd detected that a message was dropped. In an attempt to recover the message, dcd retries the operation.
When DCD is allocating heap memory, it uses a private memory allocator that writes a special pattern at the end of each allocated segment of heap memory. Later, when de-allocating this memory, DCD checks for the pattern. Not finding the previously written pattern means the memory was overwritten, which indicates an error in DCD.
Copyright
©
2011, Juniper Networks, Inc.
13
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
DFCD_GENCFG_MALLOC_FAILED
DESCRIPTION
The dynamic flow capture process (dfcd) could not allocate memory for the
GENCFG message.
DFCD_GENCFG_WRITE_FAILED
DFCD_LINH_MALLOC_FAILED
DFWD_CONFIG_WRITE_FAILED
DFWD_MALLOC_FAILED
DFWD_PARSE_STATE_EMERGENCY
DFWD_TRASHED_RED_ZONE
DH_SVC_RTSOCK_OPEN_FAILURE
DH_SVC_RTSOCK_REGISTER_FAILURE
DH_SVC_SETSOCKOPT_FAILURE
DH_SVC_SOCKET_FAILURE
ESPTASK_PARSE_CMD_ARG
ESPTASK_PARSE_CMD_EXTRA
ESWD_PPM_READ_ERROR
ESWD_PPM_WRITE_ERROR
ESWD_STP_BASE_MAC_ERROR
EVENTD_EVENT_SEND_FAILED
The dynamic flow capture process (dfcd) could not send the GENCFG message for the indicated reason.
The dynamic flow capture process (dfcd) could not allocate memory for the
LINH message.
The firewall process (dfwd) encountered an error while trying to send an interface configuration to the kernel over the routing socket.
The firewall process (dfwd) must dynamically malloc memory for its needs.
This allocation request failed. The specific data structure that was being allocated is listed in the message.
The firewall process (dfwd) encountered an unhandled internal state while parsing an interface.
When the firewall process (dfwd) is allocating heap memory, it uses a private memory allocator that writes a special pattern at the end of each allocated segment of heap memory. Later, when de-allocating this memory, dfwd checks for the pattern. Not finding the previously written pattern means the memory was overwritten, which indicates an error in dfwd.
The Dynamic Host Configuration Protocol (DHCP) services process (dhcpservice) could not successfully open a routing socket to the kernel. The error string accompanying this log entry indicates the specific error.
The Dynamic Host Configuration Protocol (DHCP) services process (dhcpservice) could not successfully register a callback function with a routing socket. The error string accompanying this log entry indicates the specific error.
The Dynamic Host Configuration Protocol (DHCP) services process (dhcpservice) could not set the indicated socket option.
The Dynamic Host Configuration Protocol (DHCP) services process (dhcpservice) could not create a socket.
This process terminated because of an internal error.
This process terminated because of an invalid option.
The ethernet bridging process (eswd) could not read a message available on the read pipe from the periodic packet management process (ppmd).
The ethernet bridging process (eswd) could not write a message on the pipe to the periodic packet management process (ppmd).
This condition occurs when STP cannot derive the base MAC address of the system.
Junos OS processes can request that the event processing process
(eventd) notify them when a specific event occurs. eventd could not send an event notification for the indicated reason.
14
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
EVENTD_FORK_ERR
DESCRIPTION
The event processing process (eventd) could not create a child process for executing policies.
EVENTD_PIPE_ERR
EVENTD_VERSION_MISMATCH
FPCLOGIN_IP_ADDRESS_GET_FAILURE
FSAD_ERROR
FUD_MEMORY_ALLOCATION_FAILURE
FUD_RTSOCK_WRITE_FAILURE
FUD_SENDMSG_FAILURE
FUD_SENDMSG_NOINT_FAILURE
FUD_SETSOCKOPT_FAILURE
FUD_SOCKET_FAILURE
GGSN_ALARM_TRAP_SEND
GGSN_TRAP_SEND
GRAPH_NO_MEMORY
HNCACHED_PATRICIA_ERROR
ICCPD_ASSERT_SOFT
ICCPD_OPEN_ERROR
IDP_DAEMON_INIT_FAILED
The event processing process (eventd) could not create a pipe for interprocess communication.
The event processing process (eventd) received an event with the indicated version indicator, which does not match the indicated version expected by eventd.
The fpclogin module attempted to get the IP address of the physical interface module. The attempt failed.
The file system access process (fsad) internal error message.
The UDP forwarding process (fud) could not allocate the indicated amount of memory from the heap.
The UDP forwarding process (fud) could not write to its routing socket for the indicated reason.
The UDP forwarding process (fud) could not send data to the indicated destination port and address using the indicated interface and routing instance, which it needs to do during normal operation.
The UDP forwarding process (fud) could not send data to the indicated destination port and address using the indicated routing instance, which it needs to do during normal operation.
The UDP forwarding process (fud) could not set the indicated socket option.
The UDP forwarding process (fud) could not create a socket.
An alarm trap to be relayed by the services PICs process (serviced) failed to initialize.
The system sent a GGSN trap of an unrecognized type.
The graphing process could not allocate memory while trying to create a graph.
A call to a Patricia tree library function returns an error.
The source code for the interchassis communication process (iccpd) includes internal self-consistency checks. As iccpd with the indicated process ID (PID) executed the binary compiled from the indicated source file, a check failed at the indicated line number in the file. iccpd created a diagnostic core file for analysis by technical support personnel and continued to run.
The interchassis communication process (iccpd) could not initialize.
An attempt to start the IDP policy daemon failed because an error was encountered during initialization.
Copyright
©
2011, Juniper Networks, Inc.
15
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
IDP_INTERNAL_ERROR
DESCRIPTION
The IDP daemon encountered an internal error.
IKED_CFG_PATRICIA_ERROR A call to a Patricia tree library function returned an error.
JCS_BBD_LOAD_FAILURE
JCS_BBD_LOCAL_MISMATCH
JCS_BBD_NOT_FOUND
JCS_BBD_NOT_VALID
JCS_BBD_PARSE_ERROR
JCS_BBD_PEER_MISMATCH
JCS_KERNEL_RSD_LINK_DOWN
JCS_MM_COMMUNICATION_ERROR
JCS_READ_BANDWIDTH_ERROR
JCS_READ_BBD_ERROR
JCS_SWITCH_COMMUNICATION_ERROR
JSRPD_DAEMONIZE_FAILED
JSRPD_EVLIB_EXIT_FAILURE
JSRPD_SOCKET_LISTEN_FAILURE
JSRPD_SOCKET_RECV_HB_FAILURE
KERNEL.*i2c_s1.*group.*device
KERNEL:.*cksum.*out of data.*
The JCS process (jcsd) could not load blade bay data for the specified blade.
The blade bay data retrieved for the specified blade does not match the data loaded during the reboot process. This error usually indicates that blade bay data in the JCS Management Module was changed since the last reboot.
The blade bay data was not found for the specified blade.
The blade bay data for the specified blade is invalid.
The blade bay data for the specified blade did not parse correctly.
The blade bay data retrieved for the specified peer blade does not match the data retrieved for the local blade. This error indicates that blade bay data in the JCS Management Module was not configured properly.
The JCS process (jcsd) has disabled kernel RSD communication for the specified reason.
The JCS process (jcsd) could not send an SNMP request to the
Management Module because of the indicated error.
The indicated error occurred when attempting to read the current switch bandwidth.
The indicated error occurred when attempting to read the current blade bay data via a sysctl call.
The JCS process (jcsd) could not send an SNMP request to the indicated
Switch Module because of the indicated error.
The Juniper Services Redundancy Protocol process (jsrpd) could not create a version of itself to run in the background as a daemon.
The Juniper Services Redundancy Protocol process (jsrpd) returned from an event loop, which it should never do.
The Juniper Services Redundancy Protocol process (jsrpd) could not successfully listen on a socket.
The Juniper Services Redundancy Protocol process (jsrpd) was not successfully received on a socket.
Fan tray response error. Error due to the fan tray processing a different task.
"/kernel: cksum: out of data" is logged in the system log.
16
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
KERNEL:.*jsr_prl_recv_ack_msg.* received PRL
ACK message
DESCRIPTION
Non-stop routing replication message acknowledgment received by backup
Routing Engine.
KERNEL:.*Voltage Fail Shutdown.*device.*
KERNEL:GENCFG: op 2 (Gencfg Blob) failed.*
KERNEL:ifd_request: RTM_ID.*
KERNEL:ifd_request: RTM_ID.*
KERNEL:parity error detected, fll reinit: mpfe.*
KERNEL:pfestat_req_receive: request.*
KERNEL:Process .* has exceeded 85% of
RLIMIT_DATA
KERNEL:rdp retransmit error
KERNEL:RT_PFE: NH IPC failed, err 6 (No
Memory)
KMD_SNMP_PIC_NO_RESPONSE
L2ALD_IPC_PIPE_WRITE_ERROR
L2ALD_PIP_IFD_READ_RETRY
L2CPD_ABORT
L2CPD_ASSERT
The ' Voltage Fail Shutdown' message is reported into the system message file if the indicated device in the syslog message has or is about to undergo a reset or due to improper grounding of the FRU causing it to go offline.
Kernel error message generated because it does not have a handler for a certain GENCFG blob message.
Some Junos OS daemons were not originally included in a list of processes that can modify an inteface definition. These messages are only informational and can be ignored.
Some Junos OS daemons were not originally included in a list of processes that can modify an inteface definition. These messages are informational only and can be ignored.
The message indicates that the Packet Forwarding Engine was reset when detecting a parity error in the ASIC.
Kernel message regarding PFE statistics counter request.
This message indicates that the virtual memory size of a process’s datasegment area (RLIMIT_DATA) has exceeded its current soft limit.
The kernel is indicating that no system buffer space is available.
The kernel is reporting that the Packet Forwarding Engine cannot install or change routing table entries because it is running out of memory.
The indicated PIC did not respond to a request from the key management process (kmd) for Simple Network Management Protocol (SNMP) statistics about IP Security (IPSec) security associations.
The Layer 2 address learning process (l2ald) could not write to an interprocess communication (IPC) pipe for the indicated reason.
The Layer 2 address learning process (l2ald) could not read the provide-inprovider interface (pip0) interface from the kernel.
The Layer 2 Control Protocol process (l2cpd) terminated because of an internal error.
The source code for the Layer 2 Control Protocol process (l2cpd) includes internal self-consistency tests. l2cpd with the indicated executable name and process ID (PID) terminated because the indicated test failed at the indicated line number in the indicated source file. The process created a diagnostic core file for analysis by technical support personnel.
Copyright
©
2011, Juniper Networks, Inc.
17
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
L2CPD_ASSERT_SOFT
DESCRIPTION
The source code for the Layer 2 Control Protocol process (l2cpd) includes internal self-consistency tests. l2cpd with the indicated executable name and process ID (PID) terminated because the indicated type of check failed at the indicated line number in the indicated source file. The process continued to run, but created a diagnostic core file for analysis by technical support personnel.
L2CPD_PPM_WRITE_ERROR
L2CPD_SCHED_SLIP
L2CPD_SYSTEM_CALL_FAILED
L2TPD_EVLIB_CREATE_FAILED
L2TPD_EVLIB_CREATE_FAILED
L2TPD_SERVER_START_FAILED
LIBESPTASK_SNMP_CONN_PROG
LIBESPTASK_SNMP_SOCKOPT_RECVBUF
LIBESPTASK_SNMP_SOCKOPT_SENDBUF
LIBJNX_DEFAULT_IP_ADDR_NOT_SET
LIBJNX_EVLIB_FAILURE
LIBJNX_EXEC_SIGNALED
LIBJNX_REPLICATE_RCP_ERROR
LIBJNX_SNMP_ENGINE_FILE_FAILURE
LIBJNX_SNMP_ENGINE_SCAN_FAILURE
The Layer 2 Control Protocol process (l2cpd) could not write a message on the pipe to the periodic packet management process (ppmd).
The Layer 2 Control Protocol process (l2cpd) delayed an event, such as issuing an adjacency establishment message that was supposed to occur at a particular time. The event did not occur at the right time.
A system call made by the Layer 2 Control Protocol process (l2cpd) failed.
The Layer 2 Tunneling Protocol process (l2tpd) could not create a context for handling asynchronous events.
The Layer 2 Tunneling Protocol process (l2tpd) could not create a context for handling asynchronous events.
The Layer 2 Tunneling Protocol (L2TP) server did not start.
The indicated error occurred while the process using libesptask was connecting to the SNMP master agent.
The process using libesptask could not set the size of the kernel receive buffer, which allows it to accept the largest possible packet from the Simple
Network Management Protocol (SNMP) master agent.
The process using libesptask could not set the size of the kernel send buffer, which allows it to send the largest possible packet to the Simple
Network Management Protocol (SNMP) master agent.
A Junos OS process could not retrieve the system default IP address from the kernel because the address is not defined there.
A Junos OS process called the indicated function in the event library. The function failed for the indicated reason.
A Junos OS process created a child process to execute the indicated command. The child process received the indicated signal and exited.
The rcp command failed during replication.
A Junos OS process could not perform the indicated operation on the indicated SNMP engine data file.
A Junos OS process could not perform the scan operation on the indicated
SNMP engine data file.
18
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
LIBJNX_SOCKET_FAILURE
DESCRIPTION
Various system processes use Transmission Control Protocol (TCP), User
Datagram Protocol (UDP), and Reliable Data Protocol (RDP) sockets. The indicated socket operation failed for the indicated reason.
LIBJSNMP_NS_LOG_EMERG SNMP errors with LOG_EMERG as severity.
LIBMSPRPC_CLIENT_INIT_FAILED
LIBMSPRPC_CLIENT_KCOM_FAILED
LIBMSPRPC_CLIENT_KCOM_NO_IF
LIBMSPRPC_CLIENT_NO_CONNECTION
LIBMSPRPC_CLIENT_NO_REPLY
LIBMSPRPC_CLIENT_PIC_DOWN
LIBMSPRPC_CLIENT_WRONG_OUTPUT
LIBSERVICED_CLIENT_CONNECTION
LIBSERVICED_SOCKET_BIND
LIBSERVICED_SOCKET_PRIVATIZE
LICENSE_EXPIRED
LICENSE_GRACE_PERIOD_APPROACHING
LICENSE_GRACE_PERIOD_EXCEEDED
LICENSE_GRACE_PERIOD_EXPIRED
LICENSE_NEARING_EXPIRY
LICENSE_SOCKET_FAILURE
A Junos OS process (mspinfo) could not establish initialization of the RPC client.
A Junos OS process (mspinfo) could not establish initialization of the KCOM subsystem.
A Junos OS process (mspinfo) could not find any configured and active extension-provider interfaces.
Remote execution of the command given from the Routing Engine to the
PIC failed. The Routing Engine cannot connect to the PIC.
Remote execution of the command given from the Routing Engine to the
PIC failed. There was no reply from the PIC.
Remote execution of the command given from the Routing Engine to the
PIC failed. The PIC is down.
Remote execution of the command given from the Routing Engine to the
PIC failed. The PIC returned unexpected output.
An attempt to establish a client connection failed.
An attempt to bind a server socket for receiving client requests failed.
An attempt to attach a socket to the management routing instance for communication between the Routing Engine and GGSN-C PICs failed.
A time-based license for a feature has expired. The feature will remain inactive until a new license is installed.
The grace period for a licensable feature is about to expire. Unless a new license is installed, the feature will become inactive after the grace period expires.
The grace period for a scale license is about to expire. Unless the scale license is upgraded, the license will scale back to the licensed limit after the grace period expires.
The grace period for a licensable feature has expired. Strict license enforcement will remain active until a new license is installed.
A time-based license for a feature is about to expire. Unless a new license is installed, the feature will become inactive after the license expires.
The indicated process encountered a system error when manipulating a socket.
Copyright
©
2011, Juniper Networks, Inc.
19
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
LLDPD_SYSTEM
DESCRIPTION
A system call made by the Link Layer Discovery Protocol process (LLDPD) failed.
LPDFD_DYN_PDB_OPEN_FAILED
LPDFD_DYN_REGISTER_FAILED
LPDFD_DYN_SDB_OPEN_FAILED
LPDFD_PCONN_SERVER
LPDFD_RTSOCK_OPEN_FAILURE
MIB2D_REALPATH_FAILURE
MIB2D_RTSLIB_READ_FAILURE
MIB2D_SNMP_INDEX_ASSIGN
MIB2D_SNMP_INDEX_DUPLICATE
MIB2D_SNMP_INDEX_UPDATE_STAT
MIB2D_SNMP_INDEX_WRITE
NSD_MEMORY_ALLOC_FAILED
NSD_SEC_NODE_COMP_SYNC_FAILED
NSTRACED_MEMORY_ALLOC_FAILED
NSTRACED_SSAMLIB_CALL_FAILED
PFE Crash
PFE: ASIC Initialization Error
The local policy decision function process (lpdfd) failed to open the profile database.
The local policy decision function process (lpdfd) failed to register with the dynamic configuration subsystem.
The local policy decision function process (lpdfd) failed to open the session database.
The local policy decision function process (lpdfd) pconn server failed to initialize.
The local policy decision function (LPDF) services process could not successfully open a routing socket to the kernel. The error string accompanying this log entry indicates the specific error.
When MIB2D is copying the /var/db/dcd.snmp_ix file, it could not resolve its real path.
A call to the indicated function in the routing socket library failed during the indicated operation on the indicated object.
MIB2D cannot assign an SNMP index for each interface.
The first interface name was assigned the same SNMP index as the second interface name.
MIB2D cannot get the status of the SNMP index file.
MIB2D cannot write to a file containing all the indices.
The network security process (nsd) could not allocate the indicated number of bytes of memory.
One or more subcomponents of the network security process (nsd) failed to synchronize their state when the nsd restarted on secondary mode.
The USP trace process (nstraced) could not allocate the indicated number of bytes of memory.
The indicated error occurred when the usp trace daemon process (nstraced) called a function in the ssamlib library or tried to process a callback from the library.
Any Packet Forwarding Engine board crash that occurs in conjunction with a system exception message.
Any Packet Forwarding Engine ASIC initialization error that occurs in conjunction with a system exception message, such as: router-name fpc5
CMG: Fatal ASIC initialization error, Offlining FPC
20
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
PFE: CMRFEB: Fatal HSL2 errors for FPC
DESCRIPTION
A switching board (for example, FEB) is reporting a bad fabric connection to an FPC.
PFE: DFW: jtree cutover failed
PFE: Failed to find MC RT_NH entry:.*
PFE: HSL2–HSL2 detected fatal error
PFE: I-CHIP New illegal link errors in WO DESRD
PFE: I-CHIP New packet errors in WO HDRF, iwo_hdrf_poll_stats
PFE: imq_stream_disable_stream
PFE: LCHIPnew errors in LSIF
PFE: mrvl_dfw_log_effuse_status:Firewall rows
PFE: Multi-bit ECC error
PFE: Multiple Correctable ECC
PFE: Multiple UnCorrectable ECC
PFE: Packet drop in Ichip
PFE: RCHIP: SRAM parity error
PFE: Route TCAM rows could not be redirected on device
The firewall filter configuration cannot be applied due to insufficient amount of contiguous memory on the SRAM.
Informational message logged when multicast next-hop traffic ages from the switch routing tables.
The FPC detected a fatal HSL2 error.
Potential ICHIP stream problem possibly due to IFL flooding. Potential match with PR/289104— might need software upgrade.
Potential ICHIP stream problem possibly due to IFL flooding. Potential match with PR/289104— might need software upgrade.
The I-chip wedge issue described in PR 277853, which can lead to packet corruption or packet loss. The Event trigger contains the string:
imq_stream_disable_stream.
The FPC is reporting LCHIP interface errors.
The TCAM error messages listed indicate a permanent non-fixable error with TCAM, if they persist after rebooting the EX Switch or Virtual Chassis
(VC). These errors are TCAM hardware issues on this FPC and are not harmless. ACLs will be unreliable on this FPC.
The Packet Forward Engine detected a multi-bit error correcting code (ECC) error in one of the forwarding engine boards.
The Packet Forward Engine board is reporting multiple correctable ECC memory errors.
The Packet Forward Engine board is reporting multiple uncorrectable ECC memory errors.
The Ichip packet writer drop counter is incrementing, possibly indicating packet drops which might, but not necessarily, be due to a faulty switching board.
SRAM parity error detected on FPC RCHIP.
The TCAM error messages listed indicate a permanent non-fixable error with TCAM, if they persist after rebooting the EX Switch or Virtual Chassis
(VC). These errors are TCAM hardware issues on this FPC and are not harmless. ACLs will be unreliable on this FPC.
Copyright
©
2011, Juniper Networks, Inc.
21
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
PFE: RT: Failed prefix change
DESCRIPTION
These messages indicate that the Routing Engine is trying to delete routes from the Packet Forwarding Engine, but it can't because the routes aren't there. This usually means the Packet Forwarding Engine has run out of memory. For example, if you bring up many BGP peers, the number of routes the Routing Engine can hold might surpass the number the Packet
Forwarding Engine can hold. In this case, the Packet Forwarding Engine runs out of memory and can't add the routes. Later, when the Routing
Engine tries to remove the routes, the prefix it’s looking for is unknown.
PFE: SDRAM ECC Error
PFE: SHEAF: possible leak
PFE: SRAM Parity Error
PFE: SRCHIP-SRAM parity error
PFE:%PFE- PIO Read error.
PFE:.*CCHIP: .*abnormal discard seen.*
PFE:.*clock error.*
PFE:.*CRC link error detected for FPC
PFE:.*mrvl_brg_port_stg_cist_init.*
PFE:.SFP receive power low warning
PFE_NH_RESOLVE_THROTTLED
PFE_PACKET_DISCARD_ERROR
Any Packet Forwarding Engine SDRAM ECC error that occurs in conjunction with a system exception message, for example: router-name fpc0 ADPC: detected 1 DDR SDRAM Single-bit ECC errors in the last 30 seconds.
Possible FPC SHEAF memory leak.
Any Packet Forwarding Engine SDRAM ECC error that occurs in conjunction with a system exception message, for example: router-name ssb CCHIP: %PFE-3: SRAM parity error 0x80000 bank 0x1.
The FPC SRCHIP has detected an SRAM parity error.
The PIO read error could indicate a hardware issue with the PIC.
Packet Forwarding Engine board is reporting CCHIP abnormal discard errors.
Clock error reported on PFE board.
Errors are a result of HSL CRC errors sent from Switch Fabric to DPC.
Initialization Warning message pertaining to MSTP/STP/RSTP configured ports for any spanning tree groups shared common IST(CIST).
SFP receive power low warning.
The Packet Forwarding Engine throttled next-hop resolution requests from the indicated interface, because the high number of requests might constitute an attempted denial-of-service (DoS) attack. Examples of events that generate next-hop resolution requests include an attempt to forward a packet without an Address Resolution Protocol (ARP) entry and receiving a multicast data packet with no matching route. Normally, the Packet
Forwarding Engine forwards the requests to the Routing Engine.
The counter for tag /pfe-hardware-statistics/fabric-discard from the junoscript call get-pfe-statistics (show pfe statistics) incremented.
22
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
PPMD_ASSERT_SOFT
DESCRIPTION
The source code for the periodic package management process (ppmd) includes internal self-consistency checks. As ppmd with the indicated process ID (PID) executed the binary compiled from the indicated source file, a check failed at the indicated line number in the file. ppmd created a diagnostic core file for analysis by technical support personnel and continued to run.
PPMD_READ_ERROR problem-event-ichipfcheck problem-event-jbuserror problem-event-l2cacheerror problem-event-lchipcrc problem-event-nfabcrcerror
RDD_EVLIB_CREATE_FAILURE
RMON_EVENT_fpc_high_buffer_utilization
RMON_EVENT_fpc_high_cpu_utilization
RMON_EVENT_fpc_high_heap_utilization
RPD_ABORT
RPD_ACTIVE_TERMINATE
RPD_ASSERT
The source code for the periodic package management process (ppmd) includes internal self-consistency checks. As ppmd with the indicated process ID (PID) executed the binary compiled from the indicated source file, a check failed at the indicated line number in the file. ppmd created a diagnostic core file for analysis by technical support personnel and continued to run.
The FPC is reporting a bad fabric connection to one or more destinations.
Another FPC is likely to be causing the packet corruption.
An error occurred on the FPC control bus used for packet memory allocation.
The Packet Forwarding Engine component is reporting that Layer 2 Cache
Single-bit ECC errors were detected in the last 30 seconds. If the problem persists, this situation is likely to result in a component crash or failure.
The outbound FPC is reporting a corrupt packet received on the Nchip-to-
Lchip interface. Another FPC is likely to be causing the packet corruption.
The fabric connection to the ingress FPC is reporting a bad connection.
The redundant interfaces process (rdd) could not create a context used for handling all asynchronous events (such as timers and message availability).
Remote monitoring event reporting high buffer utilization on FPC.
High CPU utilization on FPC.
Remote monitoring event reporting high heap utilization on FPC.
The routing protocol process (rpd) terminated because of an internal error.
After receiving multiple termination requests, the routing protocol process
(rpd) exited without performing the indicated cleanup tasks.
The source code for the routing protocol process (rpd) includes internal selfconsistency checks. A check failed at the indicated line number in the indicated source file, causing the instance of rpd that was using the indicated binary and had the indicated process ID (PID) to terminate. The process created a diagnostic core dump for analysis by technical support personnel.
Copyright
©
2011, Juniper Networks, Inc.
23
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
RPD_ASSERT_SOFT
DESCRIPTION
The source code for the routing protocol process (rpd) includes internal selfconsistency checks. A check failed at the indicated line number in the indicated source file, but the instance of rpd that was using the indicated binary and had the indicated process ID (PID) continued running. The process created a diagnostic core dump for analysis by technical support personnel.
RPD_BGP_NEIGHBOR_STATE_CHANGED
RPD_DYN_CFG_BAD_REQ_OPCODE
RPD_DYN_CFG_BUSY_SIGNAL_FAILED
RPD_DYN_CFG_GET_PROF_NAME_FAILED
RPD_DYN_CFG_GET_PROFILE_FAILED
RPD_DYN_CFG_GET_SES_STATE_FAILED
RPD_DYN_CFG_GET_SNAPSHOT_FAILED
RPD_DYN_CFG_PDB_CLOSE_FAILED
RPD_DYN_CFG_PDB_OPEN_FAILED
RPD_DYN_CFG_PROCESSING_FAILED
RPD_DYN_CFG_REGISTER_FAILED
RPD_DYN_CFG_REQUEST_ACK_FAILED
RPD_DYN_CFG_SCHEMA_OPEN_FAILED
RPD_DYN_CFG_SDB_CLOSE_FAILED
RPD_DYN_CFG_SDB_OPEN_FAILED
During the BGP negotiation with the local router, the state of the indicated
BGP neighbor (peer) changed as indicated. The ESTABLISHED state is the final state in the neighbor negotiation.
The routing protocol process (rpd) received a dynamic configuration request with an unexpected operation code.
The routing protocol process (rpd) failed to notify dynamic configuration clients about its availability to process dynamic configuration requests.
The routing protocol process (rpd) tried to get the profile name from the session snapshot and failed.
The routing protocol process (rpd) tried to load a profile from the database and failed.
The routing protocol process (rpd) failed to get the session state from the session snapshot.
The routing protocol process (rpd) tried to load client session data from the database and failed.
The routing protocol process (rpd) tried to close the profile database and failed.
The routing protocol process (rpd) tried to open the profile database and failed.
The routing protocol process (rpd) tried to process dynamic configuration and failed.
The routing protocol process (rpd) tried to register with the dynamic configuration subsystem and failed.
The routing protocol process (rpd) tried to ACK a dynamic configuration request and failed.
The routing protocol process (rpd) tried to open the configuration schema and failed.
The routing protocol process (rpd) tried to close the session database and failed.
The routing protocol process (rpd) tried to open the session database and failed.
24
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
RPD_DYN_CFG_SES_RECOVERY_FAILED
DESCRIPTION
The routing protocol process (rpd) tried to recover a session and failed.
RPD_ISIS_ADJDOWN An IS-IS adjacency with the indicated neighboring router was terminated.
The local router will no longer exchange routing information with, or direct traffic to, the neighboring router.
RPD_ISIS_LSPCKSUM
RPD_ISIS_OVERLOAD
RPD_KRT_KERNEL_BAD_ROUTE
RPD_KRT_Q_RETRIES
RPD_LMP_UNEXPECTED_OPCODE
RPD_OS_MEMHIGH
RPD_OSPF_NBRDOWN
RPD_RSVP_NBRDOWN
RPD_RT_ERROR
RPD_TASK_FORK
RT_SCREEN_TCP
RT_SCREEN_UDP
RTLOGD_DAEMONIZE_FAILED
RTLOGD_EVLIB_FAILURE
RTLOGD_GET_TNP_ADDRESS_FAILED
RTLOGD_LOG_BIND_ERROR
RTLOGD_LOG_READ_ENABLE_ERROR
The indicated IS-IS informational link-state PDU (LSP) failed an internal checksum validity test, indicating that it was corrupted.
The IS-IS link-state database is full and no additional memory can be allocated for it.
As it restarted, the routing protocol process (rpd) could not process a route obtained from the kernel because the route contained references to objects that are no longer valid.
The routing protocol process (rpd) attempted to update the kernel for the indicated times and failed. It will continue retrying.
The routing protocol process (rpd) received the indicated type of message, which had the indicated invalid operation code.
The routing protocol process (rpd) is using the indicated amount and percentage of Routing Engine memory, which is considered excessive.
An OSPF adjacency with the indicated neighboring router was terminated.
The local router will no longer exchange routing information with, or direct traffic to, the neighboring router.
The RSVP neighbor to the indicated address was terminated.
A route in the routing table was found to be in an unrecoverable error state.
The routing protocol process failed to create the indicated child process.
A TCP attack category.
A UDP attack category.
The JSR log daemon could not create a version of itself to run in the background as a daemon.
The JSR log daemon called the indicated event library function. The function failed with the indicated error.
JSR log daemon failed to determine local TNP address used to receive JSR log.
The JSR log daemon received the JSR log from a JSR log forwarder. The
JSR log daemon failed to connect to the forwarder.
The JSR log daemon received the JSR log from a JSR log forwarder. The
JSR log daemon failed to enable the reading of the JSR log from the forwarder.
Copyright
©
2011, Juniper Networks, Inc.
25
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
RTLOGD_LOG_READ_ERROR
DESCRIPTION
The JSR log daemon relayed the JSR logs from the dataplane to the system event daemon for logging. The JSR log daemon failed to read JSR logs for the indicated reason.
RTPERF_CPU_THRESHOLD_EXCEEDED The Packet Forwarding Engine CPU threshold has been exceeded.
SAVAL_RTSOCK_FAILURE
SDXD_DAEMONIZE_FAIL
SERVICED_CLIENT_DISCONNECTED
SERVICED_CLIENT_ERROR
SERVICED_COMMAND_FAILED
SERVICED_CONNECTION_ERROR
SERVICED_EVENT_FAILED
SERVICED_INIT_FAILED
SERVICED_INTERNAL_INCONSISTENCY
SERVICED_MALLOC_FAILURE
SERVICED_NETWORK_FAILURE
SERVICED_PID_FILE_LOCK
SERVICED_PID_FILE_UPDATE
SERVICED_RTSOCK_SEQUENCE
SERVICED_SIGNAL_HANDLER
SERVICED_SOCKET_CREATE
SERVICED_SOCKET_IO
SERVICED_SOCKET_OPTION
The MAC SA Validate system process (jsavald) experienced the indicated error with a routing socket.
The Service Deployment System process (sdxd) could not create a version of itself to run in the background as a daemon.
The remote client closed the connection or stopped responding.
An I/O error caused the termination of a connection with an interface client.
An error caused a command being executed on an interface client to be cancelled.
The remote client closed the connection when data was expected.
The services PICs process (serviced) could not continue processing a task because a call to a function in the event library failed.
One of the steps in the initialization sequence for the services PICs process
(serviced) failed.
An internal consistency check failed due to a mismatch between expected and received values for the specified object.
The services PICs process (serviced) could not allocate the number of bytes needed to hold the indicated object.
An attempt to use the indicated network library call failed with an error.
As a part of normal startup, the services PICs process (serviced) locks a file and writes its process ID (PID) into it. It could not lock the file.
As a part of normal startup, the services PICs process (serviced) locks a file and writes its process ID (PID) into it. It could not write to the file.
The services PICs process (serviced) encountered a sequence error while receiving messages from the routing socket library.
As a part of normal functioning, the services PICs process (serviced) attempted to initialize a signal-handling function. Part of the initialization failed with an error.
An attempt by the services PICs process (serviced) to create a new socket for communication with an interface client failed with an error.
A call to a socket library function indicated that an error occurred while attempting to perform I/O.
An attempt to set an option on a socket failed.
26
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
SERVICED_STDLIB_FAILURE
DESCRIPTION
The value returned by a call to a library function indicated that an error occurred.
SNMP_PATRICIA_ERROR
SNMP_RTSLIB_FAILURE
SNMPD_FILE_FAILURE
SNMPD_RMONFILE_FAILURE
SNMPD_SEND_FAILURE
SNMPD_SOCKET_FATAL_FAILURE
SNMPD_SUBAGENT_NO_RESOURCES
SPD_DAEMONIZE_FAILED
SPD_EVLIB_CREATE_FAILURE
A call to a Patricia tree library function returns an error.
A call to the indicated function in the routing socket library failed with the indicated error
The Simple Network Management Protocol (SNMP) agent process (snmpd) could not access the indicated file.
The indicated operation failed on the indicated remote monitoring (RMON) data file.
The Simple Network Management Protocol (SNMP) agent process (snmpd) could not send either a protocol data unit (PDU) to the User Datagram
Protocol (UDP) or a message to a subagent.
The Simple Network Management Protocol (SNMP) agent process (snmpd) uses sockets for communication with subagents. The process exited after a socket operation, such as creation or removal, failed.
The Simple Network Management Protocol (SNMP) agent process (snmpd) uses certain resources for communication with subagents. However, the resources were not available for communication with the indicated subagent.
The adaptive services process (spd) could not create a version of itself to run in the background as a daemon.
The adaptive services process (spd) could not create a context used for handling all asynchronous events (such as timers and message availability).
SPD_GEN_NUM_FAIL
SYSTEM: Alarm set: Temp Too Warm
The adaptive services process (spd) attempted to initialize the generationnumber for the service sets. However, the memory allocation failed.
The system is indicating that the sensor on an EX FPC is exceeding the temperature threshold.
SYSTEM: Keepalive timeout of *. Assuming RE mastership.
SYSTEM: SCHED: Thread.*ran for.*without yielding "Scheduler Oinker" messages seen on console at various instances with various mPIM combinations.
SYSTEM: writing kernel
The backup Routing Engine assumed mastership due to an Routing Engine keepalive timeout.
SYSTEM:.*cm_read_i2c errno is 5.*
SYSTEM:.*cm_read_i2c errno is 5.*
A kernel crash event. A writing kernel message is captured after the router reboots.
The chassis manager event message results from an error in calculating the
DC power budget for POE interfaces.
The chassis manager event message results from an error in calculating the
DC power budget for POE interfaces.
Copyright
©
2011, Juniper Networks, Inc.
27
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
SYSTEM:.*dcd.* unknown encaps_ohead; dev vlan, encaps .* flags.*
DESCRIPTION
Informational message generated by dcd deamon in syslog when certain protocols and vlans are configured (e.g., MSTI, VRRP).
SYSTEM:.*snp_igmp_io_flood: relay failed.*
TASK_OS_MEMHIGH
TASK_SYSTEM
UI_DBASE_REBUILD_FAILED
UI_DBASE_REBUILD_SCHEMA_FAILED
UI_DBASE_REOPEN_FAILED
UI_SCHEMA_SEQUENCE_ERROR
UTMD_MALLOC_FAILURE
UTMD_SSAMLIB_FAILURE
VCCPD_PROTOCOL_LSPCKSUM
VCCPD_PROTOCOL_OVERLOAD
VRRPD_MISSING_VIP
WEB_ALLOCATE
WEB_MEMORY_ALLOC
This message indicates that the device is flooding IGMP unknown packet back on the same port that it was received on.
The process is using the indicated amount and percentage of Routing
Engine memory, which is considered excessive.
A system call made by this process failed.
The management process (mgd) could not rebuild the configuration database file.
The management process (mgd) could not rebuild the schema for the configuration database.
After rebuilding the schema file for the configuration database, the management process (mgd) closes the file and reopens it in read-only mode to prevent corruption. It could not reopen the file.
The Junos OS user interface schema file records all CLI commands and configuration statements available in the Junos operating system. The management process (mgd) rebuilds the schema as necessary to be compatible with the Junos OS software installed on the device. A sequence number in the schema acts as a checksum that represents its content and format. A Junos OS process attempted to access the schema but determined that the schema's sequence number means that it is incompatible with the process.
The example process (utmd) could not allocate memory for a resource, possibly due to a lack of memory.
The example process (utmd) encountered an error while calling a function or from a callback of the ssamlib library.
The indicated vccpd link-state PDU (LSP) failed an internal checksum validity test, implying that it was corrupted.
The vccpd link-state database is full and no additional memory can be allocated for it.
The indicated interface received a Virtual Routing Redundancy protocol
(VRRP) packet for the indicated VRRP group in which the indicated Virtual
IP address was missing.
The Web management process (httpd) could not allocate the indicated amount of memory, for the indicated reason.
The Web management process (httpd) could not allocate the indicated number of bytes of memory, for the indicated reason.
28
Copyright
©
2011, Juniper Networks, Inc.
Events Detected by AI-Scripts
Table 1: Events Detected by AI-Scripts (continued)
EVENT ID
WEB_MGD_LISTEN_ERROR
DESCRIPTION
The Web management process (httpd) could not open the mgd listening socket.
WEB_SOCKET
WEBFILTER_CACHE_NOT_ENABLED
WEBFILTER_REQUEST_NOT_CHECKED
The Web management process (httpd) could not create a socket, for the indicated reason.
The category cache Web filter failed to enable.
The Web filtering failed to check a Web request.
Copyright
©
2011, Juniper Networks, Inc.
29
Summary of Release 3.0 Features
Current Software Release
The current AI-Scripts release is Release 3.0R2.
Outstanding Issues
The following issues exist in the current AI-Scripts release:
§ J Series Services Routers or SRX Series Service Gateways running Junos OS software with
Enhanced Services in cluster node configurations must have AI-Scripts installed on each node separately. There is no method for installing AI-Scripts on both nodes simultaneously with a single install command. (PR 409931/410417)
§ Use JunosScope 9.0R2 or later in conjunction with AI-Scripts 1.1R2 or later to automatically install AI-Scripts to multiple devices at once.
§ To upgrade from AI-Scripts 1.0R2 to 1.1R2:
1. Delete the existing scripts by using the request system scripts delete CLI command.
2. At the [edit groups juniper-ais event-options destinations] hierarchy level, change and commit the event-options destinations name as follows: user@host# edit groups juniper-ais event-options destinations user@host# rename juniper-junoscope to juniper-aim
§ Sometimes a device running AI-Scripts might not appear in the AIM Console. To view the device in AIM:
1. From the device to the archive location, make an sFTP or scp connection.
2. For a secure connection, ensure that the host authenticity to the AIM server is established. For example: root@staging-sw1% scp test25 [email protected]:/opt/jmb-archives1/ The authenticity of host '66.129.225.17 (66.129.225.17)' can't be established. RSA key fingerprint is 40:16:92:af:d5:7e:54:4f:ad:f7:c8:9a:9a:90:1f:95. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added ‘66.129.225.17'
(RSA) to the list of known hosts. [email protected]'s password:
§ Intelligence JMBs (iJMBs) might not appear in an AIM archive location, and, therefore, might not appear in AIM Intelligence Manager. To resolve this issue:
1. Log in to the device as root user.
2. Connect to the AIM server using an SSH connection.
3. Accept the security authentication.
4. Change the archive directory (for example, /var/aim/jmb-archives4/) permissions from the default of 755 to 733 to allow JMB files to be written using the following command:
chmod 733 jmb-archives4
To confirm directory permissions, use the following command:
ls –l
drwx-wx-wx 2 root root 4096 Sep 16 12:01 jmb-archives4
Copyright
©
2011, Juniper Networks, Inc.
30
Issues Fixed Since Last Release
Issues Fixed Since Last Release
The following issues have been fixed in this AI-Scripts release:
§ N/A
Junos OS PRs That Affect AI-Scripts
The following Junos OS PRs impact certain devices running AI-Scripts (See Table 2).
Table 2: Junos OS PRs Affecting Devices Running AI-Scripts
IMPACT ON DEVICES RUNNING AI-SCRIPTS PR/SUMMARY FIX VERSIONS
AI-Scipts for unstructured not operational
•
Junos OS Release 11.1R4 in Junos 11.1. (PR 613907)
•
Junos OS Release 11.2R2
•
Junos OS Release 11.3R1
Junos ignore event-policy has been modified starting in Junos release 11.1 such that unstructured events are suppressed and will not trigger an event-script.
Encoder error resulting in invalid JMBs
•
Junos OS Release 9.3R4 seen when performing API requests. (PR
•
Junos OS Release 9.4R3
441511)
•
Junos OS Release 9.5R2
•
Junos OS Release 9.6R1
•
Junos OS Release 10.0R1
The AI-Scripts activation sequence
•
Junos OS Release 9.6R1 repeats every hour on EX platforms. (PR
•
Junos OS Release 9.5R3
440360)
•
Junos OS Release 10.0R1
•
Junos OS Release 9.5S1
Correct the transient-commit behavior.
(PR 386499)
•
Junos OS Release 9.5R1
•
Junos OS Release 9.6R1
All Junos OS platforms running Junos OS Releases
9.3R1 - R3. 9.4R1 – R2, or 9.5R1 can experience invalid or incomplete JMBs generated when problem events are detected.
Low-end devices without a hard drive might have frequent log file rollovers, which signals eventd internal times to reset, generating an iJMB.
Every commit signals eventd internal times to reset, generating an iJMB, as well as extending the normal commit time by approximately 20 percent.
Every commit time might be extended up to 10 times the normal commit time.
AI-Scripts increase the commit time to approximately 10 times, even with and empty commit. (PR 294131)
•
Junos OS Release 9.3R1
•
Junos OS Release 9.0R4
•
Junos OS Release 9.4R1
•
Junos OS Release 9.2R3
•
Junos OS Release 9.1R4
•
Junos OS Release 9.5R1
The logger command causing an eventd
•
Junos OS Release 9.5R2 crash. (PR 428256)
•
Junos OS Release 9.4R3
•
Junos OS Release 9.6R1
Any event script that captures an event with two or more attributes might cause eventd to crash.
Copyright
©
2011, Juniper Networks, Inc.
31
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
Installing AI-Scripts
NOTE: See the “AIS Quick Setup Checklist” in the AIS User Guide for the
sequence of installing all of the AIS components.
§ AI-Scripts System Requirements on page 32
§ AI-Scripts/Service Now Compatibility on page 32
§ AI-Scripts Installation Methods on page 32
§ Downloading AI-Scripts Install Packages on page 32
§ AI-Scripts Install Package Versioning on page 33
§ AI-Scripts Install Locations on Devices on page 33
§ Automatically Installing AI-Scripts Overview on page 33
§ Automatically Installing AI-Scripts on page 34
§ Manually Configuring and Installing AI-Scripts on Devices on page 34
AI-Scripts System Requirements
Ensure that all devices on which you install AI-Scripts are running Junos OS Release 9.4 or later.
AI-Scripts/Service Now Compatibility
Use Service Now release 11.2R1 or later in conjunction with AI-Scripts releases 3.0R2. For further details regarding compatibility among versions, refer to the compatibility matrix at https://www.juniper.net/support/csc/swdist-encr/swdist-ais/ .
AI-Scripts Installation Methods
There are two ways to install AI-Scripts:
§ Automatically, using the JunosScope Script Management feature to automatically install AI-
Scripts to multiple devices at once. For more information about automatically installing AI-
Scripts, see “Automatically Installing AI-Scripts” on page 34.
§ Manually, by installing AI-Scripts on one device at time. For more information about manually installing AI-Scripts to devices, see “Manually Configuring and Installing AI-Scripts on
Downloading AI-Scripts Install Packages
AI-Scripts are released in AI-Scripts install packages. AI-Scripts install packages are available for download from the AIS download site. Also download the AI-Scripts release notes.
To download an AI-Scripts install package, follow these steps:
1. Using a Web browser, go to the following location: https://www.juniper.net/support/csc/swdist-encr/swdist-ais/
2. Log in to the Juniper Networks authentication system using the username and password supplied by Juniper Networks.
To download the software, you must have a service contract and an access account. If you do not have an access account, complete the registration form at the Juniper Networks website, https://www.juniper.net/registration/Register.jsp
.
32
Copyright
©
2011, Juniper Networks, Inc.
Installing AI-Scripts
3. Download the AI-Scripts install package. If you will install AI-Scripts manually, move the package to the /var/sw/pkg directory on the device.
If you do not move the AI-Scripts install package to the device, you have to use ftp or scp in conjunction with the request system scripts add command. (Optional) If you will use the
Junos Scope software to automatically install an AI-Scripts package to a group of devices at once, download the AI-Scripts install package on the same server as Advanced Insight
Manager (AIM).
AI-Scripts Install Package Versioning
AI-Scripts install packages are versioned as follows:
jais-m.nZx.x--signed.tgz
or
jais-2.4R1.5-signed.tgz
§ m and n are two integers that represent the software release number; m denotes the major release number; n the minor.
§ Z is a capital letter that indicates the type of software release. In most cases, it is an R, to indicate that this is released software. If you are involved in testing prereleased software, this letter might be a B (for beta-level software).
§ x.x is the software build number and spin number.
The AI-Scripts files that are in the install package are compressed into a tgz tarball file.
Each AI-Scripts install package supports up to three previous years of Junos OS releases.
The show version CLI operational command displays the version of the AI-Scripts install package that is installed on a device.
The JMB contains the output of the show version CLI command to indicate the version of the AI-
Scripts install package installed on a device.
AI-Scripts Install Locations on Devices
AI-Scripts are installed on a device hard disk in the following location:
/var/db/scripts/
AI-Scripts are installed on a device flash drive in the following location:
/config/scripts
NOTE: If you configure the load-scripts-from-flash option, the system reads AI-
Scripts from the /config/scripts/ directory; otherwise, the system reads AI-
Scripts from the /var/db/scripts/ directory. The /var/run/scripts directory will always point to the correct scripts directory.
Automatically Installing AI-Scripts Overview
Automatically installing AI-Scripts install packages to one or more devices involves AIM interaction with Junos Scope software Script Management.
The automated AI-Scripts installation process requires the following key tasks:
§ Install and set up Junos Scope 9.0 or later. See the Junos Scope Software User Guide.
§ Install AIM. See the AIS User Guide.
§ Set up AIM settings. See the AIS User Guide.
Copyright
©
2011, Juniper Networks, Inc.
33
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
§ General settings.
§ Junos Scope settings (Settings > General > JUNOScope Settings).
§ Set up AI-Scripts bundles (Settings > General > Script Bundles).
§ Set up organizations.
§ Set up user groups.
§ Set up users.
Automatically Installing AI-Scripts
You can optionally use AIM to install AI-Scripts bundles (also known as AI-Scripts install packages) on devices as long as there is a Junos Scope software installation. AIM communicates with Junos Scope to install AI-Scripts bundles on devices running Junos OS managed by Junos
Scope.
To configure auto-installation of AI-Scripts bundles to devices, follow these steps:
1. Configure the credentials used to communicate with Junos Scope.
2. Import devices that are managed by Junos Scope.
3. Configure Script Bundles settings.
4. Associate imported devices with a device group.
5. Configure the Script Bundle of the device group and set the No-copy and Unlink installation attributes.
6. Add archive locations specifying the upload command password attributes. Use the archive location local directory for JMB files only.
7. Press the Save Changes button. AIM sends a message to Junos Scope to install the selected script bundle on the associated devices.
If you do not want to use AIM to install AI-Scripts bundles, you can manually configure and install AI-Script bundles to each device separately. To install AI-Scripts bundles manually,
see “Manually Configuring and Installing AI-Scripts on Devices” on page 34.
Manually Configuring and Installing AI-Scripts on Devices
Within AIM, devices that are configured for AIS manually are automatically added to the device group that is associated with the AIM archive location to which the JMB was sent. When the AIM detects a JMB for a device that is not managed by Junos Scope Script Management, it will note it.
NOTE: If you are manually installing to a device that communicates with Junos
Space or Service Now, your login credentials must allow discovery of devices in
Junos Space. This procedure includes the configuration differences required for configuring the location for JMBs on a Junos Space device.
34
Copyright
©
2011, Juniper Networks, Inc.
Installing AI-Scripts
To manually configure and install AI-Scripts on devices, follow these steps:
1. Download AI-Scripts install packages. See “Downloading AI-Scripts Install Packages” on
2. Configure the device configuration as follows to activate AI-Scripts: a. Enter the device CLI configuration mode. Type the configure command or the edit command from the CLI operation mode. The CLI prompt changes from user@host> to
user@host# and a banner appears to indicate the hierarchy level. b. For non–Junos Space devices only: Configure an AIS destination under group juniper-
ais: user@host# set groups juniper-ais event-options destination juniper-aim {…}
This sets the AIS archive location where JMBs are deposited for a device. The group name juniper-ais is mandatory. The group destination name juniper-aim is mandatory. c. For Junos Space devices only: Set the local host address and configure an AIS destination under group juniper-ais: user@host# set groups juniper-ais interfaces lo0 unit 0 family inet address
127.0.0.1/32
This sets the local host address 127.0.0.1 to the device loopback address. It is used with the next command to ensure that JMBs can be sent to and retrieved from the local device. user@host# set groups juniper-ais event-options destination juniper-aim
archive-sites "scp://<user>@127.0.0.1://var/tmp" password <password for
user>
Configure this line exactly as shown, substituting <user> and <password for user> with the Service Now user name and password required for accessing the device. This configuration ensures the JMBs generated by AI-Scripts are sent to and from the
/var/tmp directory of the device, using the correct permissions for the device. The group name juniper-ais is mandatory. The group destination name juniper-aim is mandatory. d. Configure the commit script: user@host# set groups juniper-ais system scripts commit file jais-activate-
scripts.slax optional
The AI-Scripts installer creates this script to activate AI-Scripts on the device. The
optional setting is required to prevent the configuration from committing if the jais-
activate-scripts.slax file is not present. That file is not present until the scripts bundle is installed. e. Configure the allow-transients option to allow transient changes: user@host# set groups juniper-ais system scripts commit allow-transients
Transient changes are configuration changes made by commit scripts that do not appear in the configuration (except with a special command). f. Apply the juniper-ais group: user@host# set apply-groups juniper-ais g. (Optional) Configure the load-scripts-from-flash option: user@host# set groups juniper-ais system scripts load-scripts-from-flash
Copyright
©
2011, Juniper Networks, Inc.
35
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
NOTE: If you configure the load-scripts-from-flash option, the system reads AI-
Scripts from the /config/scripts/ directory; otherwise, the system reads AI-
Scripts from the /var/db/scripts/ directory. The /var/run/scripts directory will always point to the right scripts directory.
3. Verify that the syntax of a configuration is correct by using the configuration mode commit
check command:
[edit] user@host# commit check configuration check succeeds
4. Commit the configuration. To save software configuration changes to the configuration database and activate the configuration on the router, use the commit configuration mode command. You can issue the commit command from any hierarchy level.
[edit] user@host# commit commit complete
5. View the configuration:
Example Configuration for AIM
groups {
juniper-ais {
system {
scripts {
commit {
allow-transients;
file jais-activate-scripts.slax {
optional;
}
}
load-scripts-from-flash;
}
}
event-options {
destinations {
juniper-aim {
archive-sites {
"ftp://[email protected]/aimdemo";
}
. . .
Example Configuration for Junos Space / Service Now 1.4 and earlier:
groups {
juniper-ais {
system {
scripts {
commit {
allow-transients;
file jais-activate-scripts.slax {
optional;
}
}
}
}
36
Copyright
©
2011, Juniper Networks, Inc.
Installing AI-Scripts
interfaces {
lo0 {
unit 0 {
family inet {
address 127.0.0.1/32;
}
}
}
}
event-options {
destinations {
juniper-aim {
archive-sites {
"scp://[email protected]://var/tmp" password " ... ";
}
}
}
}
}
}
Example Configuration for Junos Space/Service Now 2.0 and later:
groups {
juniper-ais {
system {
scripts {
commit {
allow-transients;
file jais-activate-scripts.slax {
optional;
}
}
}
}
event-options {
destinations {
juniper-aim {
archive-sites {
/var/tmp;
}
}
}
}
}
}
6. If you have not moved AI-Scripts to the device, do so now. See “Downloading AI-Scripts
7. Install the AI-Scripts package using the following command (see “AI-Scripts Commands” on
user@host# request system scripts add <package-name>
8. Verify that AI-Scripts are activated: user@host# show groups juniper-ais | display commit-scripts
system {
scripts {
commit {
Copyright
©
2011, Juniper Networks, Inc.
37
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
allow-transients;
file jais-activate-scripts.slax {
optional;
}
}
}
}
event-options {
event-script {
file problem-event-pfecrash.slax;
file problem-event-dcrash.slax;
file intelligence-event-main.slax;
file SPD_EVLIB_CREATE_FAILURE.slax;
file SPD_DAEMONIZE_FAILED.slax;
file RPD_TASK_FORK.slax;
. . .}
destinations {
juniper-aim {
archive-sites {
"ftp://[email protected]/aidemo";
}
}
}
}
AI-Scripts Commands
§ Installing an AI-Scripts Package on page 38
§ Upgrading an AI-Scripts Package on page 38
§ Deleting an AI-Scripts Package on page 38
§ Rolling Back an AI-Scripts Package on page 38
§ Not Saving Copies of AI-Scripts Package Files During Installation on page 39
§ Removing AI-Scripts Packages After Installation on page 39
Installing an AI-Scripts Package
To install an AI-Scripts install package on a device, use the following command: user@host> request system scripts add package-name
Upgrading an AI-Scripts Package
To upgrade an AI-Scripts package, perform steps 1, 7, and 8 of “Manually Configuring and
Installing AI-Scripts on Devices” on page 34.
Deleting an AI-Scripts Package
To delete AI-Scripts from a router, use the following command: user@host> request system scripts delete
Rolling Back an AI-Scripts Package
After the deletion of an AI-Scripts install package, you can roll back to the last installed package by using the following command: user@host> request system scripts rollback
38
Copyright
©
2011, Juniper Networks, Inc.
Junos OS Documentation and Release Notes
Not Saving Copies of AI-Scripts Package Files During Installation
To prevent the installer from saving copies of AI-Scripts package files in the /var/sw/pkg directory, use the following command: user@host> request system scripts add no-copy package-name
NOTE: If you use the no-copy option during the jais installation, the jais package
cannot be rolled back.
You can specify the no-copy option in AIM Device Group settings by selecting the no-copy check box.
Removing AI-Scripts Packages After Installation
To remove the AI-Script bundle after successful installation, use the following command: user@host> request system scripts add unlink package-name
You can specify the unlink option in AIM Device Group settings by selecting the unlink check box.
Junos OS Documentation and Release Notes
For a list of related Junos OS documentation, see http://www.juniper.net/techpubs/software/junos/ .
If the information in the latest release notes differs from the information in the documentation, follow the Junos OS 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 http://www.juniper.net/techpubs/ .
Juniper Networks supports a technical book program to publish books by Juniper Networks engineers and subject matter experts with book publishers around the world. These books go beyond the technical documentation to explore the nuances of network architecture, deployment, and administration using the Junos operating system (Junos OS) and Juniper Networks devices.
In addition, the Juniper Networks Technical Library, published in conjunction with O'Reilly Media, explores improving network security, reliability, and availability using Junos OS configuration techniques. All the books are for sale at technical bookstores and book outlets around the world.
The current list can be viewed at http://www.juniper.net/books .
Requesting Technical Support
Technical product support is available through the Juniper Networks Technical Assistance Center
(JTAC). If you are a customer with an active J-Care or JNASC 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 http://www.juniper.net/us/en/local/pdf/resourceguides/7100059-en.pdf
.
§ Product warranties—For product warranty information, visit http://www.juniper.net/support/warranty/ .
§ JTAC hours of operation—The JTAC centers have resources available 24 hours a day, 7 days a week, 365 days a year.
Copyright
©
2011, Juniper Networks, Inc.
39
Advanced Insight Scripts (AI-Scripts) 3.0 Release Notes
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:
§ Find CSC offerings: http://www.juniper.net/customers/support/
§ Search for known bugs: http://www2.juniper.net/kb/
§ Find product documentation: http://www.juniper.net/techpubs/
§ Find solutions and answer questions using our Knowledge Base: http://kb.juniper.net/
§ Download the latest versions of software and review release notes: http://www.juniper.net/customers/csc/software/
§ Search technical bulletins for relevant hardware and software notifications: https://www.juniper.net/alerts/
§ Join and participate in the Juniper Networks Community Forum: http://www.juniper.net/company/communities/
§ Open a case online in the CSC Case Management tool: http://www.juniper.net/cm/
To verify service entitlement by product serial number, use our Serial Number Entitlement (SNE)
Tool: https://tools.juniper.net/SerialNumberEntitlementSearch/
Opening a Case with JTAC
You can open a case with JTAC on the Web or by telephone.
§ Use the Case Management tool in the CSC at http://www.juniper.net/cm/ .
§ Call 1-888-314-JTAC (1-888-314-5822 toll-free in the USA, Canada, and Mexico).
For international or direct-dial options in countries without toll-free numbers, see http://www.juniper.net/support/requesting-support.html
.
Revision History
16 December 2010—Advanced Insight Scripts (AI-Scripts) 3.0R1
1 August 2011—Advanced Insight Scripts (AI-Scripts) 3.0R2
40
Copyright
©
2011, Juniper Networks, Inc.
Revision History
Copyright
©
2011, Juniper Networks, Inc. All rights reserved.
Juniper Networks, Junos OS, Steel-Belted Radius, NetScreen, and ScreenOS are registered trademarks of Juniper
Networks, Inc. in the United States and other countries. The Juniper Networks Logo, the Junos logo, and JunosE are trademarks of Juniper Networks, Inc. All other trademarks, service marks, registered trademarks, or registered service marks are the property of their respective owners.
Juniper Networks assumes no responsibility for any inaccuracies in this document. Juniper Networks reserves the right to change, modify, transfer, or otherwise revise this publication without notice.
Products made or sold by Juniper Networks or components thereof might be covered by one or more of the following patents that are owned by or licensed to Juniper Networks: U.S. Patent Nos. 5,473,599, 5,905,725, 5,909,440, 6,192,051,
6,333,650, 6,359,479, 6,406,312, 6,429,706, 6,459,579, 6,493,347, 6,538,518, 6,538,899, 6,552,918, 6,567,902,
6,578,186, and 6,590,785.
Copyright
©
2011, Juniper Networks, Inc.
41
ดาวน์โหลด
โฆษณา