User's Guide Globe Icon

MCS: How to Log and View Events

Goal

Set up clients to log events to the Management & Control Services (MCS) event log. MCS provides a centralized location for storing and viewing logged events.

Technique

Management & Control Services (MCS) records and logs any system events that are generated either by an MCS function, or by an MCS-managed product or component. Each MCS-managed product can log its own events in the MCS event log; the types of events are specified by that product.

Event logging is used by the following Attachmate products and features:

Tasks

The following are the main tasks you need to complete for this How-To (with links to the detailed steps which follow):

  1. Enable event logging in a function or component.

  2. Configure event logging options in MCS.

  3. View logged events.


1. Enable Event Logging in a Function or Component

For some functions and components, MCS automatically logs events. For others, event logging must be enabled in the component before MCS logs events for that component.

Events are automatically logged for the following functions and components:

Event logging must be enabled for the following functions and components. Choose an item in the list to view the steps required to enable logging for that component.

To log security services events
  1. In the MCS Selection panel under MCS Functions, choose Security.

  2. Under MCS Security, choose Security Services.

  3. In the Security Services Configuration page, select a Log Level other than Disabled.

    If you select Errors Only or Errors and Info, Security Services sends its log entries to the MCS Event log. If you select Debug/Trace, log entries are sent to the location specified for stdout in your environment.

    For a description of options on this page, choose Help in the upper-right corner of the MCS window while the page is displayed.

  4. Choose Save to activate your settings.

  5. Restart the Web application server on which MCS is running.

To log ID management events
  • In the file idmanager.properties, located in your \mcs\data\mcs\idmanager\ directory, locate the option server.events.enabled and change the value to true.

    This option specifies whether or not to log ID management activities, such as requests, renewals, and releases, to the MCS event log. To minimize unnecessary consumption of system resources, you should set this value to true only when troubleshooting ID Manager. The default value is false.

Back to top

2. Configure Event Logging Options in MCS

You can specify which events you want to log, the maximum number of log files to save, and the maximum size of each log file. You can also manage log files by closing log files, opening new log files, and deleting old log files as needed.

You can make changes to your event logging options in MCS at any time. Depending on the type of changes you make, changes may be applied only to the current log file and subsequent log files.

To configure event logging options in MCS
  1. In the MCS Selection panel, point to MCS Functions and then choose Events.

  2. In the Events tree, click Manage Events.

  3. Configure event logging as needed by modifying the settings on the Settings, File Mgmt, and Filters pages. For example, in the Settings page, you can specify whether to create a new log file when the maximum log file size is reached, or to overwrite an existing file.

    For a description of the options on any of these pages, when the page is displayed, click Help in the upper-right corner of the MCS window.

  4. Click Save to activate your settings.

Back to top

3. View Logged Events

You can view logged events through the MCS View Events pane. You can use options in this pane to filter the list of logged events for easier viewing. There are two levels of filtering available.

To view logged events
  1. In the MCS Selection panel under MCS Functions, choose Events.

  2. Under Events, choose View Events, and then select the product or products for which you want to view events.

    The View Events page is displayed in the MCS Management panel, displaying the events that have been recorded to date in the current log file.

  3. Use the Error, Warning, and Information check boxes to hide or display specific types of messages. After selecting the types of messages to display, choose Apply Filters.

    Within a specific type of error, there are numbered categories that can also be selectively displayed. Whenever you select or clear a category, click Apply Filters to refresh the event list based on the selections you have made.

    Details about the selected event are displayed in the Event Message and/or Event Raw Data fields, below the event list.

  4. To view the contents of another log file, click View Other Files.

Related Topics
Bullet Logging and Viewing Events
spacer
  Attachmate