Administering Indications Using EVWEB

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

This section discusses the following topics:




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

Overview

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 include 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 Email – to send indications to your email 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.




	NOTE: 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 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 you are interested in monitoring. You can create the following types of event subscriptions 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 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 Event Subscription Using the CLI

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

# evweb subscribe -C -n <subscription name> -v<comma separated event category names>

Where:

-C: is an option used to create 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.

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




	NOTE: The -n and the -v switches are mandatory.

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

(-e [eq\ne\le\ge\bw] [:] <severity level1>[,<severity level2>])
(-v <comma separated event category names>)
(-i <comma separated EventID>)
(-t (archive\email) [<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 for creating a 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 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.

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 of this action. The Copy and create subscription feature is available only on GUI.

For more information on creating an event subscription by copying an existing event subscription using the 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 email address. 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 through EVWEB, you can change all criteria except the subscription name.

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.
Modify the required fields.
To view the command line equivalent of modifying event subscriptions using 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 CLI, enter the following command at the HP-UX prompt:

# evweb subscribe -M -n<subscription name> -v<comma separated event category names> -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 (email address or Event Archive) to store 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>])
(-v <comma separated event category names>)
(-i <comma separated EventID>)
(-t (archive\email) [<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, both of them are updated.
If you specify the location but not the criteria, the location is updated but the original criteria is 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.
The copy and modify subscription page is displayed.
Select the event subscriptions you want to modify by selecting the respective check boxes.
Select Copy and modify subscription in the action pane on the top right corner of the page.
The Copy and modify subscription page is displayed.
Modify the required fields.
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: There is no CLI equivalent of this action. The Copy and modify subscription feature is available only on GUI.




	IMPORTANT: The subscription criteria is not copied when you copy an HP Advised event subscription. Therefore, make sure 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 page.
The Delete subscriptions page is displayed.
Select the event subscriptions you want to delete, by selecting the appropriate check boxes.
Select Delete in 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 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 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 /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 email server. The FULLNAME refers to the complete name of the e-mail server. The FROMADDR refers to your e-mail address.

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 /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

Overview

Launching EVWEB for Administration

Creating EVWEB Event Subscriptions

Creating an Event Subscription Using the GUI

Creating 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