7.3 Changing a Knowledge Script Group

You can update a Knowledge Script Group to add or remove Knowledge Script Group members and to change the job properties of an existing group member.

When you update the properties of a Knowledge Script Group member, AppManager automatically propagates any changes you make to corresponding policy-based jobs. You must manually propagate changes to jobs that are not part of a monitoring policy. For information about manually propagating changes, see Manually Propagating Base Knowledge Scripts to Knowledge Script Group Members.

If you add a member to a Knowledge Script Group, it might take up to five minutes to propagate your changes to corresponding policy-based jobs.

To change a Knowledge Script Group:

  1. In the Enterprise Layout view of the Navigation pane, select the Knowledge Scripts view you want.

  2. In the view pane, browse the list to find the Knowledge Script Group you want.

  3. In the Tasks pane, click Knowledge Script Group Properties.

  4. In the Knowledge Script Group Properties window, you can add or remove Knowledge Script Group members:

    To...

    Do this...

    Remove a Knowledge Script Group member

    Click a Knowledge Script in the Knowledge Script Group Members list and click Remove. Or, click Remove All to remove all members.

    When you close the window, AppManager stops and deletes any associated policy-based jobs based on that member.

    Add a Knowledge Script Group member

    Click a Knowledge Script in the Available Knowledge Scripts list and click Add.

    When you close the window, any groups or views that use the Knowledge Script Group to monitor by policy automatically monitor corresponding resources with the new Knowledge Script.

  5. Select a Knowledge Script Group member and click Properties to update its monitoring values. In many cases, you can simply use the default schedule and values. To make changes:

    Click this tab...

    To...

    Schedule

    Change the default schedule for running the job. For more information, see Setting the Schedule.

    Values

    Adjust the threshold and other parameters for the job. For more information, see Setting the Values to Monitor and Setting Override Values.

    Actions

    Specify an action you want AppManager to take. For more information, see Specifying One or More Corrective Actions.

    Advanced

    Specify whether to filter temporary event conditions and whether to collapse duplicate events for this job into a single event or automatically acknowledge them. Additionally, you can specify data collection options for this job. For more information, see Setting Advanced Job Properties.

  6. When you are satisfied with your changes, click OK.

7.3.1 Manually Propagating Base Knowledge Scripts to Knowledge Script Group Members

If the Automatically update Derived KS properties for checked in Base KSs option is enabled, when a base Knowledge Script is updated, AppManager automatically updates the derived Knowledge Scripts for that base script, including all Knowledge Script Groups where the derived script is a member. However, you must manually propagate the updated Knowledge Script Group members to any ad hoc jobs that were started by those members. For more information, see Propagating Knowledge Script Group Members to Ad Hoc Jobs.

If the automatic update option is not enabled, you must first manually propagate the base Knowledge Script to the Knowledge Script Group members, and then propagate the updated members to any ad hoc jobs that were started by those members.

With both automatic and manual propagation, AppManager merges any additions or deletions in the base script with the target scripts or jobs but retains the existing values, including override values.

For manual propagations, you can use the Knowledge Script Propagation wizard to view all of the derived Knowledge Scripts that are pending propagation and select specific scripts to process or update all scripts. You can also right-click a base Knowledge Script in a Knowledge Scripts view and use the menu options provided.

To manually propagate a base Knowledge Script to a Knowledge Script Group member using the wizard:

NOTE:This procedure is only necessary if the automatic update option is NOT enabled.

  1. On the Global Tasks tab, click Launch KS Propagation Wizard.

  2. On the Propagation to Derived Knowledge Scripts tab, select the specific base scripts that you want to propagate, or click Select All to propagate all pending changes.

  3. When you are done making your selections, click Propagate, and then confirm that you are ready to propagate.

    AppManager updates all direct copies of the script, all Knowledge Script Group members that are based on the script, and all monitoring policy jobs for the script.

To manually propagate a base Knowledge Script to a Knowledge Script Group member using the right-click option:

NOTE:This procedure is only necessary if the automatic update option is NOT enabled.

  1. In the Enterprise Layout view of the Navigation pane, click the appropriate Knowledge Scripts view.

  2. In the view pane, right-click the Knowledge Script you want, select Propagate, and select To Derived Knowledge Scripts.

  3. Select the members that you want to update or click Select All to update all available scripts, click OK, and then confirm that you are ready to propagate.

    AppManager updates all direct copies that you selected, all Knowledge Script Group members that you selected, and all monitoring policy jobs for the Knowledge Script Group members that you selected.

7.3.2 Propagating Knowledge Script Group Members to Ad Hoc Jobs

After a Knowledge Script Group member is updated from a derived Knowledge Script, you must propagate the updated member to any ad hoc jobs that were started by that member.

For manual propagations, you can use the Knowledge Script Propagation wizard to view all of the ad hoc jobs that are pending propagation and select specific jobs to process or update all ad hoc jobs. You can also right-click the Knowledge Script Group in a Knowledge Scripts view and use the menu options provided. When you use the right-click option to propagate to ad hoc jobs, AppManager updates all of the associated ad hoc jobs in all QDBs. If you want to propagate only to ad hoc jobs running in specific QDBs, use the wizard.

To propagate a Knowledge Script Group member to ad hoc jobs using the wizard:

  1. On the Global Tasks tab, click Launch KS Propagation Wizard.

  2. On the Propagation to Ad Hoc Jobs tab, expand the members that you want to propagate to view the QDBs where ad hoc jobs are running.

  3. Select the QDBs where you want to update ad hoc jobs, or click Select All to propagate all pending changes.

  4. When you are done making your selections, click Propagate, and then confirm that you are ready to propagate.

    AppManager updates the jobs in the QDBs that you selected.

To propagate a Knowledge Script Group member to ad hoc jobs using the right-click option:

  1. In the Enterprise Layout view of the Navigation pane, click the appropriate Knowledge Scripts view.

  2. In the view pane, right-click the Knowledge Script Group that includes the member you want to propagate, select Propagate, and select To Ad Hoc Jobs.

  3. Select the member you want to propagate or click Select All to select all members that are pending propagation, click OK, and then confirm that you are ready to propagate.

    AppManager updates all ad hoc jobs that were started by the members you selected in all QDBs.

7.3.3 Copying a Knowledge Script Group

Copy a Knowledge Script Group to create a new Knowledge Script Group with a copy of each Knowledge Script Group member. In the copied Knowledge Script Group, the base Knowledge Scripts for the members of the original group are also the base scripts for the members of the copied group.

When you copy a Knowledge Script Group, AppManager prepends a new Knowledge Script Group identifier to any Knowledge Script jobs the Knowledge Script Group creates. For more information, see How Knowledge Script Groups Work.

To copy a Knowledge Script Group:

  1. In the Enterprise Layout view of the Navigation pane, select the Knowledge Scripts view you want.

  2. In the view pane, select the Knowledge Script Group you want.

  3. In the Tasks pane, click Copy Knowledge Script Group.

  4. In the Copy Knowledge Script Group window, enter the new name for the Knowledge Script Group.

    NOTE:To copy the Knowledge Script Group into a different category, change the prefix (category_) of the name. For example, to copy a Knowledge Script Group from the KSG category into a new category named KSG 2000, prefix the name with KSG 2000_.

  5. (Optional) Provide a description for the copied Knowledge Script Group.

  6. When you finish, click OK.

7.3.4 Deleting a Knowledge Script Group

To delete a Knowledge Script Group:

  1. In the Enterprise Layout view of the Navigation pane, select the Knowledge Scripts view you want.

  2. In the view pane, select the Knowledge Script Group you want.

  3. In the Tasks pane, click Delete.

NOTE:You cannot delete a Knowledge Script Group that is configured to run as part of a monitoring policy. In this case, remove the Knowledge Script Group from any monitoring policies and then delete the Knowledge Script Group. For information about removing a Knowledge Script Group from a monitoring policy, see Changing a Monitoring Policy.