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.

If you add a member to a Knowledge Script Group, it might take up to one minute 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 Knowledge Script Groups.

    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 Section 5.3, Setting the Schedule.

    Values

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

    Actions

    Specify an action you want AppManager to take. For more information, see Section 5.6, 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 Section 5.8, Setting Advanced Job Properties.

  6. Click OK to close the window.

7.3.1 Propagating a Knowledge Script Group Member to Ad Hoc Jobs

You can update all ad hoc jobs or reports a Knowledge Script Group member started by propagating:

  • The actual script logic.

  • The Knowledge Script properties, including changes to schedule, monitoring values, override values, actions, and advanced options.

AppManager stops and restarts all corresponding jobs with the Knowledge Script properties. If you are managing more than one QDB with Control Center, the propagation applies to all corresponding jobs across all QDBs.

If you configured an override value for a job parameter, the Knowledge Script propagation replaces the override value with the override value specified in the Knowledge Script, if one was specified. If an override value is not specified in the Knowledge Script, AppManager propagates the default parameter value.

For information about propagating changes to a particular Knowledge Script to running jobs or reports, see Section 5.10.2, Propagating a Knowledge Script to Ad Hoc Jobs.

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

  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 Propagate > Knowledge Script Group To Ad Hoc Jobs.

  4. In the Knowledge Script Group Propagation window, select the members to propagate.

  5. Select the components of the Knowledge Script Group members that you want to propagate to associated ad hoc jobs, and then click OK:

    Select...

    To propagate...

    Propagate knowledge script code to ad hoc jobs

    The Knowledge Script logic.

    Propagate knowledge script properties to ad hoc jobs

    The Knowledge Script properties, including schedule, monitoring values, actions, and advanced options.

7.3.2 Propagating Properties of a Knowledge Script to Knowledge Script Group Members

You can propagate the properties of a Knowledge Script or a report script, including changes to schedule, monitoring values, actions, and advanced options, to corresponding Knowledge Script Group members.

WARNING:If you propagate the properties of a Knowledge Script to a Knowledge Script Group, and that group is part of a monitoring policy, AppManager automatically updates the corresponding policy-based jobs.

Before you propagate the Knowledge Script properties of a report, ensure that you specified a value for all of the required parameters, including parameter values that are not displayed on the Values tab of the Knowledge Script Properties window.

After you propagate Knowledge Script properties to Knowledge Script Group members, you can propagate the updated Knowledge Script Group members to monitoring jobs or reports the Knowledge Script Group started. For more information, see Section 7.3.1, Propagating a Knowledge Script Group Member to Ad Hoc Jobs.

NOTE:For information about automatically propagating changes to policy-based jobs, see Section 7.3, Changing a Knowledge Script Group.

To propagate a Knowledge Script to Knowledge Script Group members:

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

  2. In the view pane, click the Knowledge Script you want and then click Propagate > Knowledge Script to Knowledge Script Group Members.

  3. In the Knowledge Script Propagation window, select the components of the Knowledge Script that you want to propagate to associated monitoring jobs:

    Select...

    To propagate...

    Propagate knowledge script code to knowledge script group members

    The Knowledge Script logic.

    Propagate knowledge script properties to knowledge script group members

    The changed monitoring values (including the schedule, actions, and advanced properties).

  4. When you finish choosing the options, click OK.

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.

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 Section 7.1.2, 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 Section 7.5, Changing a Monitoring Policy.