13-Information Center Configuration

Download


Chapter 1  Information Center Configuration

When configuring information center, go to these sections for information you are interested in:

l           Information Center Overview

l           Configuring Information Center

l           Displaying and Maintaining Information Center

l           Information Center Configuration Examples

1.1  Information Center Overview

1.1.1  Introduction to Information Center

Acting as the system information hub, information center classifies and manages system information. Together with the debugging functionality, information center offers a powerful support for network administrators and developers in monitoring network performance and diagnosing network problems.

 

&  Note:

By default, the information center is enabled. An enabled information center affects the system performance in some degree due to information classification and output. Such impact becomes more obvious in the event that there is enormous information waiting for processing.

 

The information center of the system has the following features:

I. Classification of system information

The system is available with three types of system information:

l           Log information

l           Trap information

l           Debugging information

II. Eight levels of system information

The information is classified into eight levels by severity and can be filtered by level. The more emergent the information, the smaller the severity level.

Table 1-1 Severity description

Severity

Severity value

Description

emergencies

0

The system is unavailable.

alerts

1

Information that demands prompt reaction

critical

2

Critical information

errors

3

Error information

warnings

4

Warnings

notifications

5

Normal errors with important information

informational

6

Informational information to be recorded

debugging

7

Information generated during debugging

 

Information filtering by severity works this way: information with the severity value greater than the configured threshold is not output during the filtering.

l           If the threshold is set to 0, only information with the severity being emergencies will be output;

l           If the threshold is set to 7, information of all severities will be output.

III. Ten channels and seven output destinations of system information

The system supports seven information output destinations, including the Console, console terminal (monitor), logbuffer, loghost, trapbuffer, SNMP and logfile.

The system can support ten channels. The channels 0 through 5, and channel 9 have their default channel names and are associated with seven output destinations by default. Both the names of the routers and the associations between the channels and output destinations can be changed through commands.

Table 1-2 Information channels and output destinations

Information channel number

Default channel name

Default output destination

0

console

Console (Receives log, trap and debug information)

1

monitor

Monitor terminal (Receives log, trap and debug information, facilitating remote maintenance)

2

loghost

Log host (Receives log, trap and debug information and information will be stored in files for future retrieval.)

3

trapbuffer

Trap buffer (Receives trap information, a buffer inside the router for recording information.)

4

logbuffer

Log buffer (Receives log information, a buffer inside the router for recording information.)

5

snmpagent

SNMP NMS (Receives trap information)

6

Not specified

Not specified (Receives log, trap, and debugging information)

7

Not specified

Not specified (Receives log, trap, and debugging information)

8

Not specified

Not specified (Receives log, trap, and debugging information)

9

channel9

Log file (Receives log, trap, and debugging information)

 

&  Note:

Configurations for the seven output destinations function independently and take effect only after the information center is enabled.

 

IV. Outputting system information by source module

The system is composed of a variety of protocol modules, board drivers, and configuration modules. The system information can be classified, filtered, and output according to source modules. You can use the info-center source ? command to view the supported information source modules.

To sum up, the major task of the information center is to output the three types of information of the modules onto the ten channels in terms of the eight severity levels and according to the user’s settings, and then redirect the ten information channels to the seven output destinations.

1.1.2  System Information Format

System information has the following format:

<priority>timestamp sysname module/level/digest:content

 

&  Note:

l      The closing set of angel brackets < >, the space, the forward slash /, and the colon are all required, and the percent sign % is optional in the above format.

l      Before the <priority>, there may be a %, #, or * followed by a space, indicating log, alarm, or debugging information respectively.

 

Below is an example of the format of log information to be output to a log host:

% <188>Sep 28 15:33:46:235 2005 H3C SHELL/5/LOGIN: Console login from con0

What follows is a detailed explanation of the fields involved:

I. Priority

The priority is calculated using the following formula: facility*8+severity, in which facility is local7 by default and the range of severity is 0 to 7. Table 1-1 details the value and meaning associated with each severity.

Note that there is no space between the priority and timestamp fields and that the priority takes effect only when the information has been sent to the log host.

II. Timestamp

Timestamp records the time when system information is generated to allow users to check and identify system events.

Note that there is a space between the timestamp and sysname (host name) fields.

The timestamp is in the format of Mmm dd hh:mm:ss yyyy, where

l           “Mmm” represents the month, and the available values are: Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, and Dec.

l           “dd” is the date, which shall follow a space if less than 10, for example, “ 7”.

l           “hh:mm:ss” is the local time, where “hh” is in the 24-hour format, ranging from 00 to 23, and both “mm” and ”ss” range from 00 to 59.

l           “yyyy” is the year.

III. Sysname

Sysname is the system name of the current host. You can use the sysname command to modify the sysname. (Refer to Basic System Configuration Commands in the System Volume for details)

Note that there is a space between the sysname and module fields.

IV. Module

The module field represents the name of the module that generates system information. You can enter the info-center source ? command in system view to view the module list.

Between “module” and “level” is a “/”.

V. Level (Severity)

System information can be divided into eight levels based on its severity, from 0 to 7. Refer to Table 1-1 for definition and description of these severity levels. Note that there is a forward slash between the levels (severity) and digest fields.

VI. Digest

The digest field is a string of up to 32 characters, outlining the system information.

Note that there is a colon between the digest and content fields.

VII. Content

This field provides the content of the system information.

1.2  Configuring Information Center

1.2.1  Setting to Output System Information to the Console

I. Setting to output system information to the console

To do…

Use the command…

Remarks

Enter system view

system-view

Enable information center

info-center enable

Optional

Enabled by default

Name the channel with a specified channel number

info-center channel channel-number name channel-name

Optional

Configure the channel through which system information can be output to the console

info-center console channel { channel-number | channel-name }

Optional

System information is output to the console by default, with channel 0 as the default channel.

Configure the information source for an information channel.

info-center source { module-name | default } channel { channel-number | channel-name } [ debug { level severity | state state } * | log { level severity | state state } * | trap { level severity | state state } * ] *

Required

Refer to Table 1-3 for the default output rules of system information.

Configure the format of the time stamp

info-center timestamp { log | trap | debugging } { boot | date | none }

Optional

The time stamp format for log, trap and debugging information is date by default.

 

Table 1-3 Default output rules for different output destinations

Output destination

Modules allowed

LOG

TRAP

DEBUG

Enabled/disabled

Severity

Enabled/disabled

Severity

Enabled/disabled

Severity

Console

default (all modules)

Enabled

warnings

Enabled

debugging

Enabled

debugging

Monitoring terminal

default (all modules)

Enabled

warnings

Enabled

debugging

Enabled

debugging

Log host

default (all modules)

Enabled

informational

Enabled

debugging

Disabled

debugging

Trap buffer

default (all modules)

Disabled

informational

Enabled

warnings

Disabled

debugging

Log buffer

default (all modules)

Enabled

warnings

Disabled

debugging

Disabled

debugging

SNMP NMS

default (all modules)

Disabled

debugging

Enabled

warnings

Disabled

debugging

Log file

default (all modules)

Enabled

debugging

Enabled

debugging

Disabled

debugging

 

II. Enabling the display of system information on the console

After setting to output system information to the console, you need to enable the associated display function to display the output information on the console.

Follow these steps in user view to enable the display of system information on the console:

To do…

Use the command…

Remarks

Enable the monitoring of system information on the console

terminal monitor

Optional

Enabled on the console and disabled on the monitor terminal by default.

Enable the display of debugging information on the console

terminal debugging

Required

Disabled by default

Enable the display of log information on the console

terminal logging

Optional

Enabled by default

Enable the display of trap information on the console

terminal trapping

Optional

Enabled by default

 

1.2.2  Setting to Output System Information to a Monitor Terminal

System information can also be output to a monitor terminal, which is a user terminal that has login connections through the AUX, VTY, or TTY user interface.

I. Setting to output system information to a monitor terminal

To do…

Use the command…

Remarks

Enter system view

system-view

Enable information center

info-center enable

Optional

Enabled by default

Name the channel with a specified channel number

info-center channel channel-number name channel-name

Optional

Refer to Table 1-2 for default channel names.

Configure the channel through which system information can be output to a monitor terminal

info-center monitor channel { channel-number | channel-name }

Optional

System information is output to the monitor terminal by default with channel 1 as the default channel.

Configure the information source for an information channel

info-center source { module-name | default } channel { channel-number | channel-name } [ debug { level severity | state state } * | log { level severity | state state } * | trap { level severity | state state } * ] *

Required

Configure the format of the time stamp

info-center timestamp { log | trap | debugging } { boot | date | none }

Optional

By default, the time stamp format for log, trap and debugging information is date.

 

II. Enabling the display of system information on a monitor terminal

After setting to output system information to a monitor terminal, you need to enable the associated display function in order to display the output information on the monitor terminal.

Follow these steps to enable the display of system information on a monitor terminal:

To do…

Use the command…

Remarks

Enable the monitoring of system information on a monitor terminal

terminal monitor

Required

Enabled on the console and disabled on the monitor terminal by default.

Enable the display of debugging information on a monitor terminal

terminal debugging

Required

Disabled by default

Enable the display of log information on a monitor terminal

terminal logging

Optional

Enabled by default

Enable the display of trap information on a monitor terminal

terminal trapping

Optional

Enabled by default

 

1.2.3  Setting to Output System Information to a Log Host

To do…

Use the command…

Remarks

Enter system view

system-view

Enable information center

info-center enable

Optional

Enabled by default

Name the channel with a specified channel number

info-center channel channel-number name channel-name

Optional

Refer to Table 1-2 for default channel names.

Specify a log host and configure the parameters when system information is output to the log host

info-center loghost host-ip [ channel { channel-number | channel-name } | facility local-number ] *

Required

By default, the system does not output information to a log host. If you specify to output system information to a log host, the system uses channel 2 (loghost) by default.

Configure the source interface through which log information can be output to a log host

info-center loghost source interface-type interface-number

Optional

No source interface is configured by default, and the system selects an interface as the source interface.

Configure the information source for an information channel

info-center source { module-name | default } channel { channel-number | channel-name } [ debug { level severity | state state } * | log { level severity | state state } * | trap { level severity | state state } * ] *

Required

Configure the format of the time stamp for log information

info-center timestamp loghost { date | no-year-date | none }

Optional

date by default.

 

1.2.4  Setting to Output System Information to the Trap Buffer

To do…

Use the command…

Remarks

Enter system view

system-view

Enable information center

info-center enable

Optional

Enabled by default

Name the channel with a specified channel number

info-center channel channel-number name channel-name

Optional

Refer to Table 1-2 for default channel names.

Configure the channel through which system information can be output to the trap buffer and specify the buffer size

info-center trapbuffer [ channel { channel-number | channel-name } | size buffersize ] *

Optional

System information is output to the trap buffer by default with a default channel of channel 3 (known as trapbuffer) and a default buffer size of 256.

Configure the information source for an information channel

info-center source { module-name | default } channel { channel-number | channel-name } [ debug { level severity | state state } * | log { level severity | state state } * | trap { level severity | state state } * ] *

Required

Configure the format of the time stamp

info-center timestamp { log | trap | debugging } { boot | date | none }

Optional

The time stamp format for log, trap and debugging information is date by default.

 

1.2.5  Setting to Output System Information to the Log Buffer

To do…

Use the command…

Remarks

Enter system view

system-view

Enable information center

info-center enable

Optional

Enabled by default.

Name the channel with a specified channel number

info-center channel channel-number name channel-name

Optional

Refer to Table 1-2 for default channel names.

Configure the channel through which system information can be output to the log buffer and specify the buffer size

info-center logbuffer [ channel { channel-number | channel-name } | size buffersize ] *

Optional

System information is output to the log buffer by default with a default channel of channel 4 (known as logbuffer) and a default buffer size of 512.

Configure the information source for an information channel

info-center source { module-name | default } channel { channel-number | channel-name } [ debug { level severity | state state } * | log { level severity | state state } * | trap { level severity | state state } * ] *

Required

Configure the format of the timestamp

info-center timestamp { log | trap | debugging } { boot | date | none }

Optional

The time stamp format for log, trap and debugging information is date by default.