Sun GlassFish Enterprise Server 2.1 Administration Guide

Chapter 19 Configuring Management Rules

This section contains information about setting administration policies to automate routine administration tasks, configure self-tuning of the application server for diverse runtime conditions and improve availability by preventing failures. This section also contains information on the self-management templates, which are predefined management rules that you can customize.

This section contains the following topics:

About Management Rules

Management rules enable you to automate routine administration tasks, configure self-tuning of the application server for diverse runtime condition and improve availability by preventing failures. A management rule contains an action to be taken when a specified event occurs or a set threshold is reached. You can set management rules that can automatically take corrective action, based on events that you specify.

A management rule consists of two parts — event and action:

For example, an event could be a SEVERE message logged by the EJB logger, and an action could be alerting an administrator with the log message contents. When the event happens, event data is passed as part of userData part of the

The action specified in your rule has to be implemented as a custom MBean. Therefore, before configuring a management rule, you should deploy a custom MBean designed to receive event notifications and take appropriate action. For details on developing a custom MBean and deploying it, see Chapter 14, Developing Custom MBeans, in Sun GlassFish Enterprise Server 2.1 Developer’s Guide.

The Enterprise Server provides some useful events, which you can further extend by writing custom MBeans to emit notifications. Each event can be further customized by changing its properties.

The following event types are available:

Configuring Management Rules

To configure management rules in the Admin Console:

Note –

On this page, check All Rules Enabled to enable management rules globally. If management rules are not enabled globally, none of the management rules are executed.

In addition, to enable a individual management rule, you must enable the rule on this page by clicking the box next to the rule and clicking Enable.

A rule's MBeans must also be enabled on a target. To enable MBeans, go to Custom MBeans -> MBean. On the Edit Custom MBean page, click the Target tab to access the Custom MBean Targets page, where you can enable the MBeans on some or all of the targets.

For details, see the online help.

To create management rules from the command line, use the create-management-rule command. To set properties of the management rules, use the get and set commands. To list and delete management rules, use list-management-rules and delete-management-rule. For more information, see the online help for these commands, or Sun GlassFish Enterprise Server 2.1 Reference Manual.