Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
System Fault Management Administrator's Guide: HP-UX 11i v3 > Chapter 5 Administering Indications and Instances Using HP SMH

Tracing Evweb

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

This section provides an overview of tracing and information about the various trace levels in Evweb. This section also describes administrative tasks, such as enabling, modifying, and disabling tracing.

This section addresses the following topics:

Tracing is a feature that enables you to log and report errors. You can use tracing to log information about problems encountered while using Evweb. In this document, this information is referred to as trace records. The trace records are stored in the /var/opt/sfm/log/sfm.log file. You can send the sfm.log file to the HP support center whenever you encounter a problem.

Following is a sample of the information logged in sfm.log.

01/04/06 06:50:08 EVMAN_COMMANDS ERROR 1069627450 1 Subscription with this name already exist, Please choose different name and try again.

Table 5-4 describes the fields included in the sfm.log file.

Table 5-4 Entries in sfm.log

FieldDescription

Date

Displays the date when the message was logged in the sfm.log file.

Time

Displays the time when the message was logged in the sfm.log file.

Module Name

Displays the name of the module or the providers that logged the message in the sfm.log file, for example, EVWEB_CLI and FMDProviders.

Severity

Displays the severity of the message logged in the sfm.log file.

Process ID

Displays the 10-digit process ID.

Thread ID

Displays the thread ID.

Message

Displays the text message.

 

To change the default location of the sfm.log file, you must configure the /var/opt/sfm/conf/FMLoggerConfig.xml file.

You can enable, modify, and disable tracing for an Evweb session. A session is the duration between a login and a logout. At the end of a session, tracing is automatically disabled. In an active session, the trace level remains valid until you modify it.

Evweb provides the following trace levels in the descending order of severity:

  • 1-Critical

  • 2-Error

  • 3-Warning

  • 4-Information

Table 5-5 describes the trace levels in Evweb.

Table 5-5 Trace Levels

Trace LevelDescription
1-Critical

The system logs only those situations in Evweb that cause major failures.

Example: The database server is not functioning properly or is down.

2-Error

The system logs those situations that generate an error.

Example: There is more than one subscription name. Evweb accepts only one subscription name.

Critical situations are also logged at the Error trace level.

3-Warning

The system logs situations that result in warning messages.

Example: A warning is generated when the default setting is modified.

Both critical and error situations are logged at the Warning trace level.

4-Information

The system logs situations that result in information messages.

Example: An information message is generated when a non-administrator attempts to perform a task that can be performed only by an administrator.

Critical, error, and warning situations are logged at the Information trace level.

 

The default trace level is Warning. If you set tracing to a particular severity level, all messages of that severity and above are logged in the log file.

The administrative commands for creating, modifying, and deleting subscriptions, and deleting events are stored in the /var/sam/log/samlog.log file. From the GUI, you can access the samlog.log file from HP SMH home page -> Logs -> Samlog.

NOTE: Tracing is available for administrators only.

Enabling Tracing Using the Evweb GUI

To enable tracing, complete the following steps:

  1. Log in to the System Management Homepage.

    To log in to HP SMH, enter http://<hostname>: 2301 in the address bar of a Web browser. The HP SMH login screen is displayed.

  2. Enter your user name and password in the appropriate text boxes.

  3. Click Sign In on the login screen.

    The HP SMH home page is displayed.

  4. Do one of the following:

    • Select Tools -> Subscription Administration.

      or

    • Select Logs -> Event Viewer.

    NOTE: The Enable Tracing option is not displayed if tracing is already enabled. Instead, the Disable Tracing and the Modify Tracing options are displayed.
  5. Select Enable Tracing available at the top right corner of the page.

    The Enable tracing page is displayed.

  6. Set the trace level by selecting the level from the trace level list.

  7. Select Enable Tracing.

    The tracing level is set and a confirmation message is displayed.

  8. Click OK on the confirmation message window.

For more information on enabling tracing using the HP SMH GUI, select Help on the action pane of either the Event Viewer or the Event Subscription Administration page.

Enabling Tracing Using the Evweb CLI

To enable tracing using the Evweb CLI, you must export the environment variable, EVWEB_TRACE_LEVEL. To export the environment variable, enter the following command at the HP-UX prompt:

# export EVWEB_TRACE_LEVEL=<trace value>

Tracing is now enabled. The trace value is the trace level that you have set.

Modifying Tracing Using the Evweb GUI

To modify tracing, complete the following steps:

  1. Log in to the System Management Homepage.

    To log in to HP SMH, enter http://<hostname>: 2301 in the address bar of a Web browser. The HP SMH login screen is displayed.

  2. Enter your user name and password in the appropriate text boxes.

  3. Click Sign In on the login screen.

    The HP SMH home page is displayed.

  4. Do one of the following:

    • Select Tools -> Subscription Administration.

      or

    • Select Logs -> Event Viewer.

    NOTE: The Modify Tracing option is not displayed if tracing is not enabled.
  5. Select Modify Tracing available at the top right corner of the page.

    The Modify Tracing page is displayed.

  6. Change the trace level by selecting the level from the trace level list.

  7. Select Modify Tracing.

    The tracing level is modified and a confirmation message is displayed.

  8. Click OK on the confirmation message window.

For more information about modifying tracing using the HP SMH GUI, select Help on the action pane of either the Event Viewer or the Event Subscription Administration page.

Modifying Tracing Using the Evweb CLI

To modify tracing using the Evweb CLI, enter the following command at the HP-UX prompt:

# export EVWEB_TRACE_LEVEL=<new trace value>

Tracing is now modified. The new trace value is the trace level that you have set.

Disabling Tracing Using the Evweb GUI

To disable tracing, complete the following steps:

  1. Log in to the System Management Homepage.

    To log in to HP SMH, enter http://<hostname>: 2301 in the address bar of a Web browser. The HP SMH login screen is displayed.

  2. Enter your user name and password in the appropriate text boxes.

  3. Click Sign In on the login screen.

    The HP SMH home page is displayed.

  4. Do one of the following:

    • Select Tools -> Subscription Administration.

      or

    • Select Logs -> Event Viewer.

    NOTE: The Disable Tracing option is not displayed if tracing is not enabled.
  5. Select Disable Tracing available on the top right corner of the page.

    The tracing is disabled and a confirmation message is displayed.

  6. Click OK on the confirmation message window.

For more information on disabling tracing using the HP SMH GUI, select Help on the action pane of either the Event Viewer or the Event Subscription Administration page.

Disabling Tracing Using the Evweb CLI

To disable tracing using the Evweb CLI, you must reset the trace value. To reset the trace value, enter the following command at the HP-UX prompt:

# unset EVWEB_TRACE_LEVEL

Tracing is now disabled.

NOTE: Tracing is automatically disabled at the end of an Evweb session.
Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2009 Hewlett-Packard Development Company, L.P.