26-Information Center Command

Download


Chapter 1  Information Center Configuration Commands

1.1  Information Center Configuration Commands

1.1.1  display channel

Syntax

display channel [ channel-number | channel-name ]

View

Any view

Parameter

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name, by default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

Description

Use the display channel command to display the settings of an information channel.

If no argument is specified, the settings of all channels are displayed.

Example

# Display the settings of information channel 0.

<H3C> display channel 0

channel number:0, channel name:console

MODU_ID  NAME  ENABLE    LOG LEVEL ENABLE TRAP LEVEL   ENABLE DEBUG   LEVEL

ffff0000  default  Y     warning   Y    debugging    Y       debugging

1.1.2  display info-center

Syntax

display info-center [ unit unit-id ]

View

Any view

Parameter

unit-id: Unit ID.

Description

Use the display info-center command to display system log settings and memory buffer record statistics.

Related command: info-center enable, info-center loghost, info-center logbuffer, info-center console channel and info-center monitor channel.

Example

# Display system log settings.

<H3C> display info-center

Information Center:enabled

Log host:

         2.2.2.2, channel number : 2, channel name : loghost

         language : english, host facility local : 7

Console:

        channel number : 0, channel name : console

Monitor:

        channel number : 1, channel name : monitor

SNMP Agent:

        channel number : 5, channel name : snmpagent

Log buffer:

        enabled, max buffer size:1024, current buffer size:256

        current messages:2, channel number:4, channel name:logbuffer

        dropped messages:0, overwrote messages:0

Trap buffer:

        enabled, max buffer size:1024, current buffer size:512

        current messages:27, channel number:3, channel name:trapbuffer

        dropped messages:0, overwrote messages:0

Information timestamp setting:

        log - date, trap - date, debug – boot

Table 1-1 Description on the fields of the display info-center command

Field

Description

Informati on Center:

Whether the information center is enabled.

Log host:

Status of the log host, including its IP address, used channel numbers, channel names, language and level.

Console:

Usage status of the control port, including the channel number and channel name it uses.

Monitor:

Usage status of the monitor port, including the channel number and channel name it uses.

SNMP Agent:

Usage status of the network proxy, including the channel number and channel name it uses.

Log buffer:

Usage status of the log buffer, including whether it is enabled, the utmost capacity, the current capacity, the current item number, channel name, channel number, discarded item number and covered item number.

Trap buffer:

Usage status of the trap buffer, including whether it is enabled, the utmost capacity, the current capacity, the current item number, channel name, channel number, discarded item number and cover item number.

Information timestamp setting

Time stamp settings, describing the time stamp types of log information, trap information and debug information.

 

1.1.3  display logbuffer

Syntax

display logbuffer [ unit unit-id ] [ level severity | size buffersize ]* [ | { begin | exclude | include } regular-expression ]

View

Any view

Parameter

unit-id: Unit ID.

level severity: Specifies an information severity level. The severity argument ranges from 1 to 8.

Table 1-2 Severity definitions made on the information center

Severity

Value

Description

emergencies

1

The system is unavailable.

alerts

2

Errors that need to be corrected immediately

critical

3

Critical errors

errors

4

Common errors

warnings

5

Warnings

notifications

6

Normal information that needs to be noticed

informational

7

Normal prompting information

debugging

8

Debugging information

 

size buffersize: Specifies the size of the log buffer (number of messages the log buffer holds) you want to display. The buffersize argument ranges from 1 to 1024 and defaults to 512.

|: Filters output log information with a regular expression.

begin: Displays the log information beginning with the specified characters.

exclude: Displays the log information excluding the specified characters.

include: Displays the log information including the specified characters.

regular-expression: Regular expression.

Description

Use the display logbuffer command to display the status of the log buffer and the records in the log buffer.

Example

# Display the status of the log buffer and the records in the log buffer.

<H3C> display logbuffer

Logging buffer configuration and contents:enabled

Allowed max buffer size : 1024

Actual buffer size : 512

Channel number : 4 , Channel name : logbuffer

Dropped messages : 0

Overwritten messages : 0

Current messages : 91

…………………………(Omitted)

1.1.4  display logbuffer summary

Syntax

display logbuffer summary [ level severity ]

View

Any view

Parameter

Level severity: Specifies an information severity level. The severity argument ranges from 1 to 8.

Description

Use the display logbuffer summary command to display the summary of the log buffer.

Example

# Display the summary of the log buffer.

<H3C> display logbuffer summary

EMERG ALERT CRIT ERROR WARN NOTIF INFO DEBUG

    0     0    0     0   94     0    1     0

1.1.5  display trapbuffer

Syntax

display trapbuffer [ unit unit-id ] [ size buffersize ]

View

Any view

Parameter

unit-id: Unit ID.

size buffersize: Specifies the size of the trap buffer (number of messages the buffer holds) you want to display. The buffersize argument ranges from 1 to 1024 and defaults to 256.

Description

Use the display trapbuffer command to display the status of the trap buffer and the records in the trap buffer.

Excecuting the command with the size buffersize parameters will display the latest trap records, with the number of the records being the specified size at most.

Example

# Display the status of the trap buffer and the records in the trap buffer.

<H3C> display trapbuffer

Trapping Buffer Configuration and contents:

enabled

allowed max buffer size : 1024

actual buffer size : 256

channel number : 3 , channel name : trapbuffer

dropped messages : 0

overwrote messages : 0

current messages : 6

…………………………(Omitted)

1.1.6  info-center channel name

Syntax

info-center channel channel-number name channel-name

undo info-center channel channel-number

View

System view

Parameter

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name,with up to 30 alphanumeric characters, beginning with letters.No reserved key words allowed.

Description

Use the info-center channel name command to name the channel of the specified number.

Use the undo info-center channel command to restore the default name of the channel of the specified number.

By default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

Note that, you cannot configure two different channel numbers with the same name.

Example

# Name channel 0 as “execconsole”.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center channel 0 name execconsole

1.1.7  info-center console channel

Syntax

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

undo info-center console channel

View

System view

Parameter

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name, by default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

Description

Use the info-center console channel command to enable information output to the console through a specified channel.

Use the undo info-center console channel command to disable the information output.

By default, the switch outputs information to the console using channel 0.

This command works only when the information center is enabled for the system.

Related command: info-center enable and display info-center.

Example

# Configure channel 0 to output information to the console.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center console channel 0

1.1.8  info-center enable

Syntax

info-center enable

undo info-center enable

View

System view

Parameter

None

Description

Use the info-center enable command to enable the information center.

Use the info-center enable command to disable the information center.

The switch can output system information to the log host, the console, and other destinations only when the information center is enabled.

By default, the information center is enabled.

Related command: display info-center, info-center loghost, info-center logbuffer, info-center console channel, info-center monitor channel, info-center trapbuffer, info-center snmp channel.

Example

# Enable the information center.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center enable

% Information center is enabled

1.1.9  info-center logbuffer

Syntax

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

undo info-center logbuffer [ channel | size ]

View

System view

Parameter

channel: Sets the channel through which output information goes to the log buffer.

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name, by default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

size buffersize: Specifies the size of the log buffer (number of messages the buffer holds) you want to display. The buffersize argument ranges from 0 to 1024 and defaults to 512.

Description

Use the info-center logbuffer command to enable information output to the log buffer through the specified channel (you can also set the size of the log buffer in this command).

Use the undo info-center logbuffer command to disable the information output.

By default, the switch outputs information to the log buffer using channel 4, which can hold 512 records by default.

This command works only when the information center is enabled for the system.

Related command: info-center enable and display info-center.

Example

# Configure the switch to output information to the log buffer with the size of 50.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center logbuffer size 50

1.1.10  info-center loghost

Syntax

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

undo info-center loghost host-ip-addr

View

System view

Parameter

host-ip-addr: IP address of a log host.

channel: Sets the information channel for the log host.

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name, by default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

facility: Configures the recording process of the log host.

local-number: Recording tool of the log host, ranging from local0 to local7.

language: Configures the log recording language.

Chinese, english: Switches the log recording language between Chinese and English.

Description

Use the info-center loghost command to enable information output to a log host through setting the IP address of the log host.

Use the undo info-center loghost command to disable the information output.

By default, the switch does not output information to the log host.After the switch is configured to output information to the log host, it use channel 2 by default.

This command works only when the information center is enabled for the system.

 

&  Note:

Be sure to set the correct IP address in the info-center loghost command. A loopback IP address will cause an error message, prompting invalid address.

 

Related command: info-center enable and display info-center.

Example

# Configure the Ethernet switch to send log information to the UNIX workstation whose IP address is 202.38.160.1.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center loghost  202.38.160.1

1.1.11  info-center loghost source

Syntax

info-center loghost source interface-type interface-number

undo info-center loghost source

View

System view

Parameter

interface-type: Interface type.

interface-number: Interface number.

Description

Use the info-center loghost source command to configure the source interface through which log information is sent to the log host.

Use the undo info-center loghost source command to cancel the source interface configuration.

Related command: info-center enable and display info-center.

Example

# Configure Vlan-interface 1 as the source interface through which information is sent to the log host.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center loghost source Vlan-interface 1

1.1.12  info-center monitor channel

Syntax

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

undo info-center monitor channel

View

System view

Parameter

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name, by default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

Description

Use the info-center monitor channel command to enable information output to terminals through a specified channel.

Use the undo info-center monitor channel command to disable the information output.

By default, the switch outputs information to user terminal using channel 1.

This command works only when the information center is enabled for the system.

Related command: info-center enable and display info-center.

Example

# Set channel 0 to send log information to user terminal.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center monitor channel 0

1.1.13  info-center snmp channel

Syntax

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

undo info-center snmp channel

View

System view

Parameter

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name, by default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

Description

Use the info-center snmp channel command to set the channel through which information is output to the SNMP.

Use the undo info-center snmp channel command to restore the default channel through which information is output to the SNMP, that is, channel 5.

Related command: snmp-agent and display info-center.

Example

# Set channel 6 as the SNMP information channel.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center snmp channel 6

1.1.14  info-center source

Syntax

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

undo info-center source { modu-name | default } channel { channel-number | channel-name }

View

System view

Parameter

modu-name: Module name.

default: All modules.

channel-number: Channel number to be used.

channel-name: Channel name to be used. It can be channel6, channel7, channel8, channel9, console, logbuffer, loghost, monitor, snmpagent or trapbuffer.

log: Specifies to output log information.

trap: Specifies to output trap information.

debug: Specifies to output debug information.

level: Specifies an information severity level.

severity: Information severity level. The information with severity level greater than this level will not be output.

state: Sets the information state.

state: Can be on or off.

Description

Use the info-center source command to specify the information source in the information center and the output direction.

Use the undo info-center source command to cancel the configuration of information source and output direction.

This command can be used for filtering of log, trap or debugging information. For example, it can control information output from the IP module to any direction. You can configure to output information with severity higher than “warning” to the log host, and information with severity higher than “informational” to the log buffer. You can also configure to output trap information to the log host at the same time.

The info-center source command determines the output direction according to channel name or channel number. Each output direction is assigned with a default information channel at present, as shown in Table 1-3.

Table 1-3 Default information channel

Output direction

Information channel name

Console

console

Monitor terminal

monitor

Log host

loghost

Log buffer

logbuffer

Trap buffer

trapbuffer

SNMP

snmpagent

 

Each information channel is configured with a default record, whose module name is “default” and module number is 0xffff0000. In the record, the default settings for log, trap and debug information may differ with channels. If no record is configured for a channel, this default record is adopted.

Example

# Configure to output the log information of the VLAN module on the snmp channel, and only output the log information above the “emergencies” severity.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center source vlan channel snmpagent log level emergencies

1.1.15  info-center synchronous

Syntax

info-center synchronous

undo info-center synchronous

View

System view

Parameter

None

Description

Use the info-center synchronous command to enable synchronous terminal output, so that if system information (such as log information) is output when the user is inputting, the command prompt and input information are echoed after the output (note that, the command prompt is echoed in command edit state but is not echoed in interactive state).

Use the undo info-center synchronous command to disable synchronous terminal output.

By default, the synchronous terminal output function is disabled.

 

&  Note:

l      By enabling the synchronous terminal output function with the info-center synchronous command, you can avoid users’ input from being interrupted by system information output.

l      Running the info-center synchronous command during debug information collection may result in a command prompt echoed after each item of debug information. To avoid unnecessary output, it is recommended that you disable synchronous terminal output in such cases.

 

Example

# Enable synchronous terminal output.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C]info-center synchronous

 Current IC terminal output sync is on

1.1.16  info-center timestamp

Syntax

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

undo info-center timestamp { log | trap | debugging }

View

System view

Parameter

log: Specifies log information.

trap: Specifies trap information.

debugging: Specifies debug information.

boot: Specifies to adopt the time elapsed since system boot, which is in the format of “xxxxxx.yyyyyy”, where xxxxxx is the high 32 bits and yyyyyy the low 32 bits of the elapsed milliseconds.

date: Specifies to adopt the current system date and time, which is in format “yyyy/mm/dd-hh:mm:ss:ms” for Chinese environment and “Mmm dd hh:mm:ss:ms yyyy” for English environment.

none: Specifies not to include time stamp in specified output information.

Description

Use the info-center timestamp command to set the format of time stamp included in the log/trap/debug information or specify not to include time stamp in the information.

Use the undo info-center timestamp command to restore the default time stamp format.

By default, the date time stamp is adopted for all types of information.

Example

# Set the boot time stamp for debug information.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center timestamp debugging boot

1.1.17  info-center timestamp loghost

Syntax

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

undo info-center timestamp loghost

View

System view

Parameter

date: Specifies to adopt the current system date and time, which is in format “yyyy/mm/dd-hh:mm:ss:ms” for Chinese environment and “Mmm dd hh:mm:ss:ms yyyy” for English environment.

no-year-date: Specifies to adopt the current system date and time excluding the year, which is in format “mm/dd-hh:mm:ss:ms” for Chinese environment and “Mmm dd hh:mm:ss:ms yyyy” for English environment.

none: Specifies not to include time stamp in output log information.

Description

Use the info-center timestamp loghost command to set the format of time stamp to be sent to the log host.

Use the undo info-center timestamp loghost command to restore the default time stamp format.

By default, the date time stamp is adopted.

Example

# Set the no-year-date time stamp for output information sent to the log host.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center timestamp loghost no-year-date

1.1.18  info-center trapbuffer

Syntax

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

undo info-center trapbuffer [ channel | size ]

View

System view

Parameter

size: Sets the size of the trap buffer.

buffersize: Size of the trap buffer, represented by the number of messages it holds, ranging from 0 to 1024 and defaulting to 256.

channel: Sets the channel through which information is sent to the trap buffer.

channel-number: Channel number, ranging from 0 to 9, corresponding to the 10 channels of the system.

channel-name: Channel name. By default, the name of channel 0 to channel 9 is (in turn) console, monitor, loghost, trapbuffer, logbuffer, snmpagent, channel6, channel7, channel8, channel9.

Description

Use the info-center trapbuffer command to enable information output to the trap buffer.

Use the undo info-center trapbuffer command to disable information output to the trap buffer.

By default, the switch outputs information to the log buffer using channel 3.

This command takes effect only after the information center function is enabled.

Related command: info-center enable and display info-center.

Example

# Enable the switch to send information to the trap buffer, whose size is set to 30.

<H3C> system-view

System View: return to User View with Ctrl+Z.

[H3C] info-center trapbuffer size 30

1.1.19  reset logbuffer

Syntax

reset logbuffer [ unit unit-id ]

View

User view

Parameter

unit-id: Unit ID.

Description

Use the reset logbuffer command to clear information in the log buffer.

Example

# Clear information in the log buffer.

<H3C> reset logbuffer

1.1.20  reset trapbuffer

Syntax

reset trapbuffer [ unit unit-id ]

View

User view

Parameter

unit-id: Unit ID.

Description

Use the reset trapbuffer command to clear information in the trap buffer.

Example

# Clear information in the trap buffer.

<H3C> reset trapbuffer

1.1.21  terminal debugging

Syntax

terminal debugging

undo terminal debugging

View

User view

Parameter

None

Description

Use the terminal debugging command to enable debug terminal display.

Use the undo terminal debugging command to disable debug terminal display.

By default, debug terminal display is disabled.

You can run the terminal debugging command to display debug information on a user terminal.

Related command: debugging commands in the System Maintaining and Debugging part of the manual.

Example

# Enable debug terminal display.

<H3C> terminal debugging

% Current terminal debugging is on

1.1.22  terminal logging

Syntax

terminal logging

undo terminal logging

View

User view

Parameter

None

Description

Use the terminal logging command to enable log terminal display.

Use the undo terminal logging command to disable log terminal display.

By default, log terminal display is enabled for console users and terminal users.

Example

# Disable log terminal display.

<H3C> undo terminal logging

% Current terminal logging is off

1.1.23  terminal monitor

Syntax

terminal monitor

undo terminal monitor

View

User view

Parameter

None

Description

Use the terminal monitor command to enable the debug/log/trap terminal display function.

Use the undo terminal monitor command to disable the function.

By default, this function is enabled for the console user and terminal users.

This command works only on the current terminal. Only after the command has been executed in user view, can the debug/log/trap information be output on the current terminal. Disabling the function has the same effect as executing the following three commands: undo terminal debugging, undo terminal logging and undo terminal trapping. That is, no debug/log/trap information will be displayed on the current terminal. If the function is enabled, you can run the terminal debugging/undo terminal debugging, terminal logging/undo terminal logging or terminal trapping/undo terminal trapping command to enable or disable debug/log/trap terminal output respectively.

Example

# Disable terminal display.

<H3C> undo terminal monitor

% Current terminal monitor is off

1.1.24  terminal trapping

Syntax

terminal trapping

undo terminal trapping

View

User view

Parameter

None

Description

Use the terminal trapping command to enable trap terminal display.

Use the undo terminal trapping command to disable trap terminal display.

By default, trap terminal display is enabled.

Example

# Enable trap terminal display.

<H3C> terminal trapping

% Current terminal trapping is on