5.1 Understanding Upgrade Methods

After you upgrade the agent, existing ad hoc jobs on the agent computer are not automatically upgraded to use the latest Knowledge Script functionality. Upgrading ad hoc jobs to use the latest Knowledge Script version allows the jobs to take advantage of the latest Knowledge Script logic and properties. If you customized any job parameter values and want to retain the customizations, you have the option to only upgrade the Knowledge Script logic. Any associated graph data and event information are also retained if they have not changed. If the latest version of a Knowledge Script includes new parameters, for example, to create different events or data streams, the default values for the new parameters in the latest Knowledge Script are used.

You do not need to manually upgrade monitoring policy jobs. When a Knowledge Script that is a member of the Knowledge Script Group that started the job is upgraded, the changes are automatically propagated to the job.

The method you use to upgrade ad hoc jobs depends on whether the jobs are associated with default-named Knowledge Scripts or renamed Knowledge Scripts. You can upgrade the following types of jobs:

  • Ad hoc jobs

  • Ad hoc Knowledge Script Group jobs

You can use the Knowledge Script propagation feature in Control Center or run the AMAdmin_UpgradeJobs Knowledge Script to upgrade ad hoc jobs associated with default-named Knowledge Scripts. For more information about using the Knowledge Script propagation feature, see Section 5.2, Upgrading Ad Hoc Jobs for Default-named Knowledge Scripts and Knowledge Script Group Members Using Propagation. For more information about using the AMAdmin_UpgradeJobs Knowledge Script, see Section 5.3, Upgrading Jobs for Default-named Knowledge Scripts Using AMAdmin_UpgradeJobs.

You can use the Knowledge Script Propagation wizard in Control Center to upgrade ad hoc jobs associated with renamed Knowledge Scripts. For more information about upgrading ad hoc jobs associated with renamed Knowledge Scripts, see Section 5.4, Upgrading Ad Hoc Jobs Associated with Renamed Knowledge Scripts and Knowledge Script Group Members.