Administering Indications Using EVWEB

This section provides an overview of EVWEB and describes how to use EVWEB for administrative tasks, such as creating and managing subscriptions for indications.

This section addresses the following topics:




	NOTE: You must be an administrator to create, modify, and delete event subscriptions.

EVWEB Overview

The SFM includes a user component called EVWEB, which enables you to administer and view WBEM indications generated on the local system on which SFM is installed.

EVWEB includes the following components:

Event Subscription Administration – to subscribe to indications
Event Archive database – to store indications you have subscribed to
Event Viewer – to view indications present in the Event Archive
Indication Consumer for Event Archive – to store indications in the Event Archive
Indication Consumer for E-mail – to send indications to your e-mail address

EVWEB provides the following user interfaces to create and manage event subscriptions and view indications:

Browser-based Graphical User Interface (GUI)
Command-Line Interface (CLI)

EVWEB supports the following user groups:

Administrator
Non-administrator

In the CLI, any user with root privileges is an administrator. However, in the HP SMH GUI, the user groups in EVWEB are mapped internally to the user groups defined in HP SMH.

The Administrator user group in HP SMH maps to administrators in EVWEB. The Operator and the User user group in HP SMH map to non-administrators in EVWEB.

For information on how to configure user groups in HP SMH, see the HP System Management Homepage User’s Guide at:

http://www.docs.hp.com

Launching EVWEB for Administration

You can launch EVWEB either through the CLI or through the HP SMH GUI.

To launch EVWEB for administering event subscriptions using the CLI, enter the following command at the HP-UX prompt:

# evweb subscribe

To use HP SMH GUI to launch EVWEB for administering event subscription, complete the following steps:

Log in to HP SMH.
To log in to HP SMH, enter http://<hostname>: 2301 in the address bar of the Web browser. The HP SMH login screen is displayed.
Enter your user name and password in the appropriate text boxes.
Click Sign In on the login screen.
The HP SMH home page is displayed.
Select Tools in the main menu.
The Tools page is displayed. This page displays the applications that are plugged into HP SMH.
Select Subscription Administration in Evweb.
The Event Subscription Administration page is displayed.

You can perform various administrative tasks such as creating, modifying, and deleting event subscriptions on this page.

Creating EVWEB Event Subscriptions

You can create event subscriptions for the WBEM indications that you want to monitor. You can create the following event subscription types using EVWEB:

Admin Defined event subscriptions – Event Subscriptions created using the sfmconfig command are called Admin Defined event subscriptions. You can modify and delete Admin Defined event subscriptions using the sfmconfig command. You cannot use the evweb list, evweb subscribe, or the evweb eventviewer command to create and delete Admin Defined event subscriptions.
Event subscriptions created using the HP SMH GUI (Event Subscription Administration) – You can create these event subscriptions using the GUI or the CLI. You can modify and delete the event subscriptions that are created using Event Subscription Administration.
To create an event subscription using Event Subscription Administration, you must specify the following:
- A unique name for the event subscription
- Criteria such as device, event ID, and the severity of the event
- The location where the event must be stored

You can create an event subscription using the following methods:

Create a completely new event subscription.
Copy an existing event subscription and modify it.

Creating an Event Subscription Using the GUI

To create a new event subscription, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select Create subscription in the action pane on the top right corner of the Event Subscription Administration page.
The Create Subscription page is displayed.
Provide appropriate information in the fields present in the Create Subscription page.
NOTE: It is mandatory to specify a unique name for creating an event subscription.
To view the command line equivalent of creating event subscriptions using GUI, click Preview on the Create Subscription page. This step is optional.
Select Create on the Create Subscription page.
EVWEB creates the event subscription and displays a confirmation message.
Click OK on the confirmation message window.

For more information on creating subscription using the HP SMH GUI, select Help on the action pane of the Create Subscription page.

Creating an Event Subscription Using the CLI

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

# evweb subscribe -C -n <subscription name>

Where:

-C: is an option used to create event subscriptions.

-n: is a switch used to specify a name for an event.

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




	NOTE: The -n switch is mandatory.

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

(-e [eq|ne|le|ge|bw] [:] <severity level1>[,<severity level2>])
(-v <event category name>)
(-i <EventID>)
(-t (archive\e-mail) [<handler properties>])
-r

For more information on creating event subscriptions using CLI, see evweb_subscribe(1).

Copying and Creating a New Event Subscription Using the GUI

You can reuse the existing subscriptions to create another subscription. To create an event subscription by copying an existing event subscription, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select the event subscription you want to copy, from the event subscription table.
Select Copy and create subscription in the action pane on the top right corner of the Event Subscription Administration page.
The Copy and create subscription page is displayed.

Modify the required fields.




	IMPORTANT: The subscription criteria is not copied when you copy an HP Advised event subscription. Therefore, ensure that you specify the subscription criteria in the Copy and Create Subscription page.




	NOTE: It is mandatory to specify a unique name in the Subscription Name.

Select Create on the Copy and Create Subscription page.
EVWEB creates the event subscription and displays a confirmation message.
Click OK on the confirmation message window.
NOTE: There is no CLI equivalent for this action. The Copy and create subscription feature is available only on the HP SMH GUI.

For more information on creating an event subscription by copying an existing event subscription using the HP SMH GUI, select Help on the action pane of the Copy and Create Subscription page.

Modifying EVWEB Event Subscriptions

You can modify an event subscription by modifying the criteria and location. However, the fields that you are allowed to modify depend on the type of event subscription you select. You can modify more than one subscription at a time.




	NOTE: The HP Known event subscriptions are classified as HP Advised and Admin Defined.

In HP Advised event subscriptions, the events are stored in the event archive by default. The default location of the events cannot be modified. However, you can direct the events to your e-mail address or to the syslog. You cannot change any other subscription criteria.

In Admin Defined event subscriptions, the events are stored in the event archive by default. The default location of the events can be modified. You can store events in the event archive, direct them to your e-mail address, or do both. You cannot change any other subscription criteria.

In event subscriptions created using EVWEB, you can change all criteria except the name of the subscription.

You can modify an event subscription in the following ways:

Modify a single event subscription.
You can modify a single event subscription using the modify feature by selecting the event subscription from the event subscription table.
Modify similar criteria in multiple event subscriptions.
You can modify similar criteria in multiple event subscriptions by using the Copy and Modify subscription feature.

Modifying an Event Subscription Using the GUI

To modify an event subscription, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select Modify subscription in the action pane on the top right corner of the page.
The Modify subscription page is displayed.
Select the event subscription, which you want to modify, from the Event Subscription Table.
Modify the required fields.
To view the command line equivalent of modifying event subscriptions using the GUI, click Preview on the Modify subscription page. This step is optional.
Select Modify in the Modify subscription page.
EVWEB modifies the event subscription and displays a confirmation message.
Click OK on the confirmation message window.

For more information on modifying an event subscription using the HP SMH GUI, select Help on the action pane of the Modify Event Subscription page.

Modifying an Event Subscription Using the CLI

To modify an event subscription using the CLI, enter the following command at the HP-UX prompt:

# evweb subscribe -M -n<subscription name> -v<event category name> -t <E-mail address>

Where:

-M: is an option used to modify event subscriptions.

-n: is a switch used to specify a name for an event.

-v: is a switch used to specify the category of an event.

-t: is a switch used to specify the location (e-mail address or Event Archive) of an event.

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




	NOTE: The -n switch is mandatory.

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

(-e [eq\ne\le\ge\bw] [:] <severity level1>[,<severity level2>])
(-i <EventID>)
(-t (archive\e-mail) [<handler properties>])
-r

To modify an event subscription, you must specify the criteria and the location. Following are the ways in which you can modify an event subscription:

If you do not specify the -r option and the location, the current location is retained and the subscription criteria are updated.
If you specify the -r option but not the location, the current location is removed and only the subscription criteria is updated.
If you specify both subscription criteria and location, then both of them are updated.
If you specify the location but not the criteria, the location is updated but the original criteria are retained.

For more information on creating event subscriptions using the CLI, see evweb_subscribe(1).

Copying and Modifying an Event Subscription Using the GUI

To modify an event subscription by copying an existing event subscription, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select the event subscriptions you want to copy, from the event subscription table.
Select Copy and modify subscription in the action pane on the top right corner of the page.
The criteria and the destination information is copied. The copy and modify subscription page is displayed.
Select the event subscriptions you want to modify by selecting the respective check boxes.
Modify the required fields.
NOTE: You can modify multiple subscriptions at-a-time. You must specify a unique name in the Subscription Name.
Select Modify in the Copy and modify subscription page.
EVWEB modifies the event subscriptions and displays a confirmation message.
Click OK on the confirmation message window.
NOTE: The Copy and modify subscription feature is available only on the GUI.




	IMPORTANT: The subscription criteria are not copied when you copy an HP Advised event subscription. Therefore, ensure that you specify the subscription criteria in the Copy and modify subscription page.

For more information on copying and modifying an event subscription using the HP SMH GUI, select Help on the action pane of the Copy and Modify Event Subscription page.

Deleting EVWEB Event Subscriptions

You must periodically delete event subscriptions that are not required. You can delete a single event subscription or multiple event subscriptions at a time.

Deleting an Event Subscription Using the GUI

To delete an event subscription, complete the following steps:

Repeat steps 1-5 from “Launching EVWEB for Administration”.
Select Delete subscription in the action pane on the top right corner of the Event Subscription Administration page.
The Delete subscriptions page is displayed.
Select the event subscriptions you want to delete, by selecting the appropriate check boxes.
Select Delete on the Delete subscription page.
The event subscriptions are deleted and a confirmation message is displayed.
Click OK on the confirmation message window.




	NOTE: You cannot delete HP Advised event subscriptions and Admin Defined event subscriptions.

For more information on deleting an event subscription using the HP SMH GUI, select Help on the action pane of the Delete Event Subscription page.




	NOTE: HP recommends deleting all unwanted event subscriptions. Retaining a large number of event subscriptions may increase the size of the Event Archive, and may affect the tasks you perform using Event Subscriptions Administration.

Deleting an Event Subscription Using the CLI

To delete an event subscription using the CLI, enter the following command at the HP-UX prompt:

# evweb subscribe -D -f -n <subscription name>




	NOTE: The `-n` switch is mandatory.

Where:

-D: is an option used to delete event subscriptions.

-n: is a switch used to specify a name for an event.

-f: is a switch used to force the command. This switch can be used only with the -D option. If the -f switch is not used, EVWEB prompts for a confirmation before deleting an event subscription.

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




	NOTE: Using the CLI, you can delete only one event subscription at a time.

For more information on deleting event subscriptions using the CLI, see evweb_subscribe(1).

Configuring E-mail Consumer

The E-mail Consumer is a component of EVWEB that receives indications from the WBEM Services and redirects them to an SMTP server. Normally, the local system itself is the e-mail server. In such cases, you need not configure the E-mail Consumer.

If the e-mail server is not on the local system, you must configure the E-mail Consumer.

To configure the E-mail Consumer, complete the following steps:

Open the /var/opt/sfm/conf/evweb.conf file on the system.

Change the IP address, FULLNAME, and the FROMADDR (From Address) of the host and save the file.

The IP address is the address of the e-mail server. The FULLNAME refers to the complete name of the e-mail server. The FROMADDR refers to e-mail address that sends the event notifications.

Following is a sample evweb.conf file with IP address, FULLNAME, and the FROMADDR configured:

<EVWEB>
		<CONSUMER>
			<EMAILCONSUMER>
				<EMAILSERVER>
					<IP>127.0.0.1</IP>
					<FULLNAME>localhost</FULLNAME>
				 </EMAILSERVER>
					<FROMADDR>evweb@hp.com</FROMADDR>
			</EMAILCONSUMER>
		</CONSUMER>
</EVWEB>

Enter the following command at the HP-UX prompt:
# /opt/sfm/bin/sfmconfig -c /var/opt/sfm/conf/evweb.conf

The following message is displayed at the HP-UX prompt:

loaded the control provider

The E-mail Consumer is successfully configured.

Administering Indications Using EVWEB

Technical documentation

» Table of Contents

» Glossary

» Index

EVWEB Overview

Launching EVWEB for Administration

Creating EVWEB Event Subscriptions

Creating an Event Subscription Using the GUI

Creating an Event Subscription Using the CLI

Copying and Creating a New Event Subscription Using the GUI

Modifying EVWEB Event Subscriptions

Modifying an Event Subscription Using the GUI

Modifying an Event Subscription Using the CLI

Copying and Modifying an Event Subscription Using the GUI

Deleting EVWEB Event Subscriptions

Deleting an Event Subscription Using the GUI

Deleting an Event Subscription Using the CLI

Configuring E-mail Consumer