Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

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

    Installing AI-Scripts on a Device

    AI-Scripts provide the intelligence to a device running Junos OS to detect hardware or software failures.

    Junos Space Service Now is shipped with a default AI-Scripts bundle. If needed, you can download other versions of the AI-Scripts bundle from the Juniper Networks website (AI-Scripts - Download Software) and add them to Service Now.

    You must select event scripts from the AI-Scripts bundle to create an event profile and install the event profile on a device running Junos OS. Juniper Message Bundles (JMBs) are generated on the device only for those events that have event scripts included in the event profile.

    We recommend that you first identify five of the most common events for which you want JMBs generated and select event scripts only for those events to be installed on the device from the AI-Scripts bundle. This helps you to observe the effect of the AI-Scripts configuration on the device, for example, memory consumed while generating JMBs, the frequency a JMB is generate for an event, performance of the device while JMB is generated, and so on. Install the scripts for other events using a new event profile after your observation.

    Before you begin, ensure that you have the following:

    • A valid service contract with Juniper Networks
    • An user account to access Juniper Networks tools and resources

      If you do not have a user account, fill up the registration form at https://www.juniper.net/registration/Register.jsp to create a user account.

    Installing AI-Scripts on a device involves the following tasks:

    Adding AI-Scripts Bundle to Service Now

    To add an AI-Scripts bundle to Service Now:

    1. Access AI-Scripts - Download Software.

      The AI-Scripts – Download Software page appears.

    2. On the AI-Scripts - Download Software page, click the Software tab
    3. Click the AI-Scripts Install Package of the AI-Scripts release that you want to download. Use the Version drop-down list to select an AI-Scripts release version.

      By default, the releases in the latest version are listed on the AI-Scripts - Download Software page.

      The LOGIN page appears.

    4. Log in to the Juniper Networks authentication system with the username and password provided by Juniper Networks.
    5. Click the AI-Scripts Install Package link to download the AI-Scripts Install package to your local file system.
    6. From the Service Now navigation tree, select Administration > Event Profiles > Script Bundles > Add Script Bundle.

      The Add Script Bundle page appears as shown in Figure 1.

      Figure 1: Add Script Bundle Dialog Box

       Add Script Bundle Dialog
Box
    7. Click Browse.

      The file upload dialog box of your Web browser appears.

    8. Locate the AI-Scripts bundle in your local file system and click Upload.

      The AI-Scripts bundle is uploaded to Service Now and appears on the Script Bundles page.

    Creating an Event Profile Using an AI-Scripts Bundle

    To create an event profile from an AI-Scripts bundle:

    1. From the Junos Space Service Now navigation tree, select Administration > Event Profiles > Add Event Profile.

      The Add Event Profile page appears as shown in Figure 2.

      Figure 2: Add Event Profile Page

      Add Event Profile Page
    2. In the Profile Name field, enter a name for the event profile.

      The name can contain alphanumeric characters and the Underscore (_), hyphen (-), and space special characters. The maximum number of characters allowed is 255.

    3. In the Description field, enter a description for the event profile.

      The maximum number of characters allowed is 255.

    4. From the Script Bundle drop-down list, select the AI-Scripts bundle from which you want to select event scripts to be included in the event profile.
    5. Select the check box next to Event Synopsis to include all the event scripts present in the selected AI-Scripts bundle, in the event profile.

      Alternatively, you can include specific events scripts by selecting the check boxes provided next to the event scripts.

    6. (Optional) Click the Show Selected Events link to view and verify the event scripts included in the event profile.
    7. Click Submit.

      The Save Event Profile dialog box appears. The dialog box displays a link to apply the event profile to devices manually and another link to return to the Profiles page.

    8. Click Return to the Profiles page to return to the event profiles page.

    After an event profile is created, it can be installed on a device running Junos OS.

    installing the Event Profile on Devices

    To install event profiles on devices running Junos OS:

    1. From the Service Now navigation tree, select Administration > Event Profiles.

      The event profiles page appears.

    2. Select the event profile that you want to install on the devices and select Push to devices from the Actions menu. Alternatively, right-click the event profile and select Push to devices.

      The Push to Devices page appears as shown in Figure 3.

      Figure 3: Push to Devices Dialog Box

      Push to
Devices Dialog Box
    3. Select the devices on which you want to install the event profile.

      When the event profile is installed, a copy of the AI-Scripts bundle from which the event profile is created is stored on the device.

    4. (Optional) If you do not want to save a copy of the AI-Scripts bundle on the device, select the Never store Script Bundle files on device (if selected roll-back option will not be available) check box.

      By default, this check box is not selected and the AI-Scripts bundle is stored in the device in which it is installed.

    5. (Optional) If you want to remove the AI-Scripts bundle from the device after it is installed, select the Remove Script Bundle files after successful install check box.

      By default, this check box is not selected and the AI-Scripts bundle is stored in the device in which it is installed.

    6. (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.

      Note:

      • 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.slax file 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.
    7. Click Submit.

      The Potential Exposure when Event Profile is installed on Devices page appears. An ! icon is placed next to the devices that are susceptible to the events in the event profile.

    8. Click Continue.

      The Install Event Profile dialog box appears. With this dialog box, you can remove devices from the list by clearing their respective check boxes.

    9. Click Install.

      The Job Information dialog box displaying the job ID appears. To view the status of this job, click the job ID link. The Jobs page displays the status of the job.

      If you have installed the event profile on a dual Routing Engine, the results displayed on the Jobs page show the status for both the primary Routing Engine and the backup Routing Engine. A Failed status indicates that the installation failed on either of the Routing Engines.

    10. Click OK.

      The View Event Profiles page appears.

    Modified: 2017-06-08