Installing an Event Profile on a Device by Using Service Now
An event profile defines a set of event policies selected from an AI-Scripts bundle to generate Juniper Message Bundles (JMBs) for informing users about an event when the event occurs on a device.. When you install an event profile on managed devices, the event policies detect the events that occur on devices and automatically provide the information needed to troubleshoot the events.
Service Now uses the Device Management Interface (DMI) to install and remove AI-Scripts on devices. DMI is an extension to the NETCONF network management protocol.
When you install event profiles on devices with dual Routing Engines, Service Now installs the event profile on both primary and backup Routing Engines.
A Service Now partner cannot install event profiles on a Service Now end-customer’s devices.
For information about behavior of AI-Scripts when installed on specific product families, see https://kb.juniper.net/InfoCenter/index?page=content&id=KB29188.
The icon appears on the left side of a device row on the Service Now Devices page if the versions of the AI-Scripts installed on the device and Service Now are different. For a device with dual Routing Engine, the icon also indicates that the version of the AI-Scripts installed on the primary and backup Routing Engines are different. If you place the cursor on the icon, the tool tip displays a message similar to the following:
There is a mismatch of the AI-Scripts installed on routing engine on device.
To install an event profile on devices:
- From the Service Now navigation tree, select Administration
> Service Now Devices.
The Service Now Devices page appears.
- Select the device on which you want to install the event
The Install Event Profile action is active even if the devices are not associated with an organization or Device Group.
- From the Actions list or right-click menu, select Device Operations > Install Event Profile.
The Install Event Profile page appears as shown in Figure 1.
- Select a device group from the Add to Device Group drop-down list to add the device to the device group.
- Select an event profile from the Use Profile drop-down list to assign to the device.
- (Optional) Enter your comments for installing the event
profile in the Commit Comment text box.
The maximum number of characters allowed is 225. Service Now adds a default comment as Commit Issued by Service Now for enabling AI-Scripts.
This option is not available if the Alter device configuration to enable AI-Script events on device check box is not selected.
When a Service Now device is deleted from Service Now, the commit comment present in the Advanced Settings page is used while committing AI-Scripts configuration on a device.
You can view the commit comment on a device by executing the show system commit command.
- (Optional) If you do not want to save a copy of the event
profile after it is installed on the device, select the Never
store Script Bundle files on device (if selected roll-back option
will not be available) check box.
This option is not available during the installation of event profiles on the QFX3000-M, QFX3000-G and EX Series devices with dual Routing Engines.
- (Optional) If you want to remove the script bundle from
the device after it is installed, select the Remove Script Bundle
files after successful install check box.
This option is not available during the installation of event profiles on QFX3000-M, QFX3000-G, and EX Series devices with dual Routing Engines.
- (Optional) if you do not want the device configuration
to be modified while committing the event profile on the device, clear
the Alter device configuration to enable AI-Script events on
device check box.
By default, this option is selected.
If you clear the Alter device configuration to enable AI-Script events on device check box and the static AI-Scripts configuration is not present on the device, Service Now only installs the AI-Scripts bundle on the device. The static AI-Scripts configuration must be committed on the device manually and the
/var/db/scripts/op/ais-param-set.slaxfile executed for AI-Scripts to generate JMBs.
When you install or upgrade AI scripts releases earlier than Release 5.0 on a device using Service Now Release 15.1 or later, the static AI-Scripts configuration must be pushed manually to the device for each installation and upgrade irrespective of whether the Alter device configuration to enable AI-Script events on device check box is selected or cleared.
- (Optional) If you want to schedule a time for installing
the event profile, select the Schedule at a later time check
box, and specify the Date and time for the installation.
The installation process begins automatically at the time you specify.
- Click Submit.
- (Optional) If you want to add devices on which you want to install the selected event profile, select the Install Event Profiles on new Devices check box, and select the devices.
- Click Finish.
The Save Event Profile dialog box appears.
- Do one of the following: Click one of the following links
based on the required results.
Apply the event profile to devices manually.
To apply the event profile to devices manually:
- Click the Apply this Event Profile to Devices manually link.
- Click the devices on which you want to apply the event profile.
- Click OK.
The Job Information dialog box displays the job ID. To view the status of the event profile installation task, click the job ID link. The Jobs page displays the status of the job. Double-click the job to view information about each step of the installation.
- Click OK to return to the Event Profiles page.
Return to the Event Profiles page
Click Return to the Event Profiles Page to return to the Event Profiles page.