Administering Throttling Configuration Policy Using EVWEB

This section describes how to use EVWEB for administrative tasks, such as creating and managing throttling configuration policies.

This section discusses the following topics:

Overview

Throttling Configuration is a feature that enables you to administer a throttling policy. A throttling policy contains various parameters such as severity, event number, device category, suppression time, and threshold value. These parameters control event generation thresholds, their severities, and event suppression criteria. EVWEB provides one default throttling policy. For more information on throttling policy, see Table 3-1.

The Throttling Configuration feature enables you to qualify an event and the Event Subscription Administration component enables you to subscribe to an event. Based on the throttling configuration and event subscriptions, you receive events generated on a single managed system.

A throttling configuration can be associated with more than one subscription. However, one subscription cannot be associated with more than one throttling configuration. When a subscription is associated with a throttling configuration, the events delivered to that subscription's target are generated based on the policy settings in the throttling configuration. The throttling configuration and a subscription can be created independent of each other. By default, EVWEB associates an event subscription with the default throttling configuration.

The Throttling Configuration feature is available on both HP 9000 and HP Integrity Systems. On HP 9000 systems, EVWEB supports the Throttling Configuration feature on fpl and la64_core_hw monitors.

Creating Throttling Configuration

You can create a throttling configuration policy and associate it with an event subscription. The HP Advised subscriptions are associated with the default throttling configuration policy.

Creating a Throttling Configuration Using the GUI

To create a throttling configuration, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select Manage Throttling Configurations in the action pane on the top right corner of the page.
The Manage throttling configuration page is displayed.
Select Create throttling config in the action pane on the top right corner of the page.
The Create throttling config page is displayed.
Provide appropriate information in the fields present in the Create throttling config page.
NOTE: The throttling configuration name must be unique. The throttling policy file name must contain the absolute path of the file and the throttling configuration policy strings.
To view the command line equivalent of creating throttling configuration using GUI, click Preview on the Create throttling config page. This step is optional.
Select Create on the Create throttling page.
EVWEB creates the throttling configuration and displays a confirmation message.
Click OK on the confirmation message window.

For more information on creating a throttling configuration using the HP SMH GUI, select Help on the action pane of the Create throttling config page.

Creating a Throttling Configuration Using the CLI

To create an throttling configuration using CLI, enter the following command at the HP-UX prompt:

# evweb subscribe -T -c -g <throttling configuration name>\ -p<throttling configuration policy file name>

Where:

-T: is an option used to administer a throttling configuration.

-c: is a switch used to create a throttling configuration.

-g: is a switch used to specify a name for the throttling configuration.

-p: is a switch used to specify the path to the throttling configuration policy file.

A message stating that the execution of the evweb subscribe command was successful is displayed on the screen.

You can also use the following switches with the -T option:

(-l)
(-s <throttling configuration description>)




	NOTE: The -g switch is mandatory with the -c, -m, -d, and the -l switches. The -p switch is mandatory if you use the -c switch.

For more information on creating throttling configuration using CLI, see evweb_subscribe(1).

Copying and Creating Throttling Configuration

You can copy an existing throttling configuration and create a throttling configuration. By default, the description and the throttling policy of the existing throttling configuration is copied to the new throttling configuration. You can specify a new throttling policy while copying and creating a throttling configuration.

Copying and Creating a Throttling Configuration Using the GUI

To copy an existing throttling configuration to create a throttling configuration, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select Manage Throttling Configurations in the action pane on the top right corner of the page.
The Manage throttling configuration page is displayed.
Select Copy and create throttling config in the action pane on the top right corner of the page.
The Copy and create throttling config page is displayed.
Select the throttling configuration you want to copy, from the Throttling Configuration Summary Table.
Provide appropriate information in the fields present in the Copy and create throttling config page.
NOTE: The throttling configuration name must be unique. The throttling policy file name must contain the absolute path of the file and the throttling configuration policy strings.
Select Create on the Copy and create throttling config page.
EVWEB creates the throttling configuration and displays a confirmation message.
Click OK on the confirmation message window.
NOTE: There is no CLI equivalent of this action. The Copy and create throttling configuration feature is available only on GUI.

EVWEB creates temporary files and stores it in the /var/tmp directory. The temporary files contain the throttling configuration policy, which can be used for future references. For more information on copying and creating a throttling configuration using the HP SMH GUI, select Help on the action pane of the Copy and create throttling config page.

Modifying Throttling Configuration

You can modify a throttling configuration by modifying the criteria in the Modify Throttling Config page. However, you cannot change the name of a throttling configuration. Also, you cannot change the default throttling configuration.

Modifying a Throttling Configuration Using the GUI

To modify a throttling configuration, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select Manage Throttling Configurations in the action pane on the top right corner of the page.
The Manage throttling configuration page is displayed.
Select Modify throttling config in the action pane on the top right corner of the page.
The Modify Throttling Config page is displayed.
Modify the required fields.
NOTE: You cannot modify the name of the throttling configuration.
Select Modify on the Modify Throttling Config page.
EVWEB modifies the throttling configuration and displays a confirmation message.
Click OK on the confirmation message window.

As a result of modifying throttling configuration, EVWEB creates temporary files and stores it in the /var/tmp directory. These files contain the throttling configuration policy, which can be used for future references. For more information on modifying a throttling configuration using the HP SMH GUI, select Help on the action pane of the Modify Throttling Config page.

Modifying a Throttling Configuration Using the CLI

To modify a throttling configuration using CLI, enter the following command at the HP-UX prompt:

# evweb subscribe -T -m -g<throttling configuration name>\ -p <throttling configuration policy file name> -s\ <throttling configuration description>

Where:

-T: is an option used to administer a throttling configuration.

-m: is a switch used to modify the throttling configuration.

-g: is a switch used to specify the name of a throttling configuration that you want to modify.

-p: is a switch used to specify the path to the throttling configuration policy file.

-s: is a switch used to provide description for a throttling configuration.

A message stating that the execution of the evweb subscribe command was successful is displayed on the screen.




	NOTE: The -g switch is mandatory with the -m switch.

You can also use the following switches with the -T option:

(-l)
-h

For more information on modifying a throttling configuration using the CLI, see evweb_subscribe(1).

Deleting Throttling Configuration

You must periodically delete throttling configurations that are not required. You can delete a single throttling configuration or multiple throttling configurations at a time.

Deleting a Throttling Configuration Using the GUI

To delete a throttling configuration, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select Manage Throttling Configurations in the action pane on the top right corner of the page.
The Manage throttling configuration page is displayed.
Select Delete throttling config in the action pane on the top right corner of the page.
The Delete Throttling Config page is displayed.
Select the throttling configurations you want to delete, by selecting the appropriate check boxes.
Select Delete on the Delete Throttling Config page.
The throttling configurations are deleted and a confirmation message is displayed.
NOTE: You cannot delete the default throttling configuration and throttling configurations that are associated with a subscription.
Click OK on the confirmation message window.

If you attempt to delete a throttling configuration, which is associated with a subscription, EVWEB displays the following error message:

Error occured while executing the request. Please check log file for more details.

EVWEB logs the following information in the sfm.log file:

06/15/07 07:58:40 EVWEB_COMMANDS ERROR 25921 1 CIM_ERR_FAILED: A GENERAL ERROR OCCURRED THAT IS NOT COVERED BY A MORE SPECIFIC ERROR CODE.: "Cannot delete throttlingconfig: It is asociated with other subscriptions."

For more information on deleting a throttling configuration using the HP SMH GUI, select Help on the action pane of the Delete Throttling Config page.

Deleting a Throttling Configuration Using the CLI

To delete a throttling configuration using the CLI, enter the following command at the HP-UX prompt:

# evweb subscribe -T -d -g <throttling configuration name>

Where:

-T: is an option used to administer a throttling configuration.

-d: is a switch used to delete a throttling configuration.

-g: is a switch used to specify the name of a throttling configuration that you want to modify.




	NOTE: The `-g` switch is mandatory with the -d switch.

A message stating that the execution of the evweb subscribe command was successful is displayed on the screen.

For more information on deleting a throttling configuration using the CLI, see evweb_subscribe(1).

Administering Throttling Configuration Policy Using EVWEB

Technical documentation

» Table of Contents

» Glossary

» Index

Overview

Creating Throttling Configuration

Creating a Throttling Configuration Using the GUI

Creating a Throttling Configuration Using the CLI

Copying and Creating Throttling Configuration

Copying and Creating a Throttling Configuration Using the GUI

Modifying Throttling Configuration

Modifying a Throttling Configuration Using the GUI

Modifying a Throttling Configuration Using the CLI

Deleting Throttling Configuration

Deleting a Throttling Configuration Using the GUI

Deleting a Throttling Configuration Using the CLI