[ Contents] [ Prev] [ Next] [ Report an Error]

Installing AI-Scripts

Q. What are the AI-Scripts installation system requirements?

AI-Scripts run on Juniper Networks J-series, M-series, MX-series, T-series, EX-series, and SRX-series devices. Ensure that all devices on which you install AI-Scripts are running JUNOS Release 9.0 or later. For the latest AI-Scripts information, see the AI-Scripts Release Notes located at http://www.juniper.net/support/.

Q. What versions of JUNOS does an AI-Script installation package support?

Each AI-Script install package supports at least 3 previous years of JUNOS software releases.

Q. When do you install AI-Scripts in the AIS setup?

It does not matter whether AI-Scripts or AIM is installed first. However, for both, it is necessary to know the archive location (archive-site destination) used for devices to send incident and intelligence JMBs and for AIM to retrieve this data. You can add the archive location to the device JUNOS configuration for both AI-Scripts and AIM after the initial installation, but the components are not usable until the archive location is configured.

Q. How can you install AI-Scripts?

There are two ways to install AI-Scripts:

Q. How are AI-Scripts versioned?

AI-Script install packages are versioned as follows:

jais-m.nZx.x-signed.tgz

For example:

jais-1.0R1.5-signed.tgz

Q. From where do you download AI-Script installation packages?

Using a Web browser, go to the following location:

http://www.juniper.net/support/csc/swdist-encr/ais/

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 Web site, https://www.juniper.net/registration/Register.jsp.

Q. Where do you move AI-Script installation packages on the device?

Download the AI-Scripts install package.

If you are installing an AI-Scripts install package 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.

If you will use the JUNOScope software to automatically install a package to a group of devices at once, download the AI-Scripts install package to the same server as Advanced Insight Manager (AIM).

Q. Where are AI-Scripts installed on a device?

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 event-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.

Automatic AI-Scripts Installation Using JUNOScope 9.0 or Later Software and AIM

Q. How do you install AI-Scripts automatically using JUNOScope software?

For the latest AI-Scripts installation information, see the AI-Scripts Release Notes and AIS User Guide

Q. Does AIM need JUNOScope?

No, AIM does not need JUNOScope. However, you can optionally install AI-Scripts on JUNOS 9.0 or later devices that are managed by JUNOScope, then import these devices into AIM using JUNOScope Settings.

Manual AI-Scripts Installation

Q. What are the AI-Scripts installation Quick Steps?

  1. Download the AI-Scripts installation package from the Juniper Networks Software Download site. See Q. From where do you download AI-Script installation packages?
  2. Copy the AI-Scripts package to the Juniper Networks device. See Q. Where do you move AI-Script installation packages on the device?
  3. Configure AI-Scripts on the device and commit. See Q. How do I configure AI-Scripts to run on a device?
  4. Activate the AI-Scripts package on the device.
  5. Install the AI-Scripts package. For more information about working with AI-Scripts, see AI-Scripts Commands.
  6. Verify that the AI-Scripts are activated. Use the show configuration groups juniper-ais|display commit-scripts command. The event-options/event-script section should have a long list of *.slax files if the AI-Scripts are activated correctly.

Q. How do I configure AI-Scripts to run on a device?

  1. Enter the configure command or the edit command to enter configuration mode. The CLI prompt changes from user@host> to user@host# and a banner appears to indicate the hierarchy level.
  2. Enter an AIS destination under group juniper-ais:
    user@host# set groups juniper-ais event-options destination juniper-ais {...}

    This configuration determines the AIS archive location where JMBs are deposited for a device.

  3. Configure the commit script:
    user@host# set groups juniper-ais system scripts commit file jais-activate-scripts.slax optional

    The AI-Script installer creates this script to activate AI-Scripts on the device.

  4. 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 committed configuration (except with a special command).

  5. Apply the juniper-ais group:
    user@host# set apply-groups juniper-ais

    This configuration applies the configuration group juniper-ais.

  6. (Optional) Configure the load-scripts-from-flash option:
    user@host# set groups juniper-ais system scripts load-scripts-from-flash

    Note: If you configure the load-scripts-from-flash option, the system reads AI-Scripts from /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.

  7. Verify that the syntax of the configuration is correct by using the configuration mode commit check command:
    [edit]
    user@host# commit check
    configuration check succeeds
  8. 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
  9. View the configuration:
    groups {
        juniper-ais {
            system {
                scripts {
                    commit {
                        allow-transients;
                        file jais-activate-scripts.slax {
                            optional;
                        }
                    }
                    load-scripts-from-flash;
                }
            }
            event-options {
                destinations {
                    juniper-junoscope {
                        archive-sites {
                            "ftp://anonymous@10.7.0.124/aimdemo";
                        }
                    . . .
    
  10. If you have not moved the AI-Script to the device, do so now. See Q. Where do you move AI-Script installation packages on the device?.
  11. Install the AI-Script package. (For more information about working with AI-Script packages, see AI-Scripts Commands).
    request system scripts add <package-name>
  12. Verify that the AI-Scripts are activated:
    user@host# show configuration groups juniper-ais | display commit-scripts
    system {
        scripts {
            commit {
                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-junoscope {
                archive-sites {
                    "ftp://anonymous@10.7.0.124/aimdemo";
                }
            }
        }
    }
    

Q. On a router with dual Routing Engines, should AI-Scripts be installed on both Routing Engines?

Yes, install the AI-Scripts on each Routing Engine.

Q. How do you verify that AI-Scripts are activated?

Use the show configuration groups juniper-ais|display commit-scripts command:

user@host# show configuration groups juniper-ais | display commit-scripts
system {
    scripts {
        commit {
            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-junoscope {
            archive-sites {
                "ftp://anonymous@10.7.0.124/aimdemo";
            }
        }
    }
}

The event-options/event-script section should have a long list of *.slax files if the AI-Scripts are activated correctly.

Q. After installing AI-Scripts, how do you test the JMB flow from the network device to AIM?

Check the following:

Q. How soon after AI-Scripts installation is a intelligence iJMB generated?

An iJMB is generated within 5 minutes after AI-Scripts installation.

Q. How can you tell what version of AI-Scripts is installed on a device?

The show version CLI operational command displays the version of the AI-Script 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-Script install package installed on a device. You can view the JMB in AIM Incident Manager or Intelligence Manager.


[ Contents] [ Prev] [ Next] [ Report an Error]