Chapter 1 Information Center Configuration Commands
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
Syntax
display info-center
[ unit unit-id ]
View
Any view
Parameter
unit-id: Unit
ID.
Description
Use the display info-center command
to display the operation status of information center, the configuration of
information channels, the format of time stamp and the information output in case
of fabric.
Related command: info-center
enable, info-center loghost, info-center logbuffer,
info-center console channel, info-center monitor
channel, info-center trapbuffer, info-center snmp channel,
and info-center timestamp
Example
# Display the operation status of
information center, the configuration of information channels, the format of
time stamp of the current system and the information output status in the IRF
system.
<H3C> display info-center
Information Center: enabled
Log host:
the interface name of the
source address : Vlan-interface1
192.168.0.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 : 512,
current messages : 512,
channel number : 4, channel name : logbuffer
dropped messages : 0,
overwrote messages : 586
Trap buffer:
enabled,max buffer size :
1024, current buffer size : 256,
current messages : 5, channel
number : 3, channel name : trapbuffer
dropped messages : 0,
overwrote messages : 0
Information timestamp setting:
log - date, trap - date,
debug - boot
IRF SWITCH OF Device--Unit>1: LOG
= enable; TRAP = enable; DEBUG = enable
Table 1-1
Description on the fields of the display info-center
command
|
Field
|
Description
|
|
Information Center
|
Whether the information center is enabled
|
|
Log host
|
Information about the log host, including
its IP address, name and number of information channel, language and level of
the log host
|
|
Console
|
Information about the console port,
including name and channel of its information channel
|
|
Monitor
|
Information about the monitor port,
including name and channel of its information channel
|
|
SNMP Agent
|
Information about SNMP Agent, including name
and number of its information channel
|
|
Log buffer
|
Information about the log buffer,
including its state (enabled or disabled), its maximum size, current size, current
messages, information channel name and number, dropped messages, and
overwritten messages
|
|
Trap buffer
|
Information about the trap buffer,
including its state (enabled or disabled), maximum size, current size,
current messages, channel number and name, dropped messages, and overwritten
messages
|
|
Information timestamp setting
|
Information about time stamp setting,
describing log information, trap information, and the time stamp format of
the debugging information
|
|
IRF SWITCH OF Device--Unit>1
|
Information about the state of the device
(enabled or disabled), describing whether the log, trap and debugging
information are enabled on the device
|
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
|
Emergent errors
|
|
alerts
|
2
|
Errors that need to be corrected
immediately
|
|
critical
|
3
|
Critical errors
|
|
errors
|
4
|
Errors that need to be considered but are
not critical
|
|
warnings
|
5
|
Warnings that prompt possible errors
|
|
notifications
|
6
|
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 1,024 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
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 statistics 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
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 1,024 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.
If you execute the command with the size
buffersize parameter, the device will display the latest trap records.
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
#Dec 31 14:01:25 2004 H3C DEV/2/LOAD
FINISHED:
Trap
1.3.6.1.4.1.2011.2.23.1.12.1.20: frameIndex is 0, slotIndex 0.4
#Dec 31 14:01:33 2004 H3C DEV/2/BOARD
STATE CHANGE TO NORMAL:
Trap
1.3.6.1.4.1.2011.2.23.1.12.1.11: frameIndex is 0, slotIndex 0.2
#Dec 31 14:01:40 2004 H3C DEV/2/BOARD
STATE CHANGE TO NORMAL:
Trap
1.3.6.1.4.1.2011.2.23.1.12.1.11: frameIndex is 0, slotIndex 0.
……
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, up to 30 characters in length. The name must start with an English
letter, containing no special character but numbers and English letters only..
Description
Use the info-center channel name
command to name the channel whose number is channel-number as channel-name.
Use the undo info-center channel command
to restore the default name of the channel whose number is channel-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
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 set the channel through which information is output to
the console.
Use the undo info-center console channel
command to restore the default channel.
By default, the switch outputs information
to the console.
This command works only when the information
center is enabled.
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
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 undo 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, and 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
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 information outputs 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 1,024 and defaults to 512.
Description
Use the info-center logbuffer
command to enable information output to the log buffer.
Use the undo info-center
logbuffer command to disable the information output.
By default, the switch outputs information
to the log buffer, which can hold 512 records by default.
This command works only when the information
center is enabled.
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
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 to the log host.
By default, the switch does not output information
to the log host.
This command works only when the information
center is enabled.
Be sure to set the
correct IP address in the info-center loghost command. A loopback
IP address will cause an error message, prompting that the address is invalid.
Related command: info-center
enable and display info-center.
Example
# Configure the Ethernet switch to send 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
Syntax
info-center
loghost source interface-type interface-number
undo info-center
loghost source
View
System view
Parameter
interface-type: Specifies an interface type.
interface-number: Specifies an interface number.
Description
Use the info-center loghost
source command to configure the source interface through which 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
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 set the channel through which information is output to user
terminals.
Use the undo info-center monitor
channel command to restore the information output channel to the default
channel.
By default, the switch outputs information
to user terminals.
This command works only when the information
center is enabled.
Related command: info-center
enable and display info-center.
Example
# Set channel 0 to send information to user
terminals.
<H3C> system-view
System View: return to User View with
Ctrl+Z.
[H3C] info-center monitor channel 0
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
agent.
Use the undo info-center snmp
channel command to restore the default channel through which information is
output to the SNMP agent, that is, channel 5.
Related command: snmp-agent and display
info-center.
Example
# Set the switch to output information to
the SNMP agent through channel 6.
<H3C> system-view
System View: return to User View with
Ctrl+Z.
[H3C] info-center snmp channel 6
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: Defaults
the settings of all modules.
channel-number:
Number of information channel to be used.
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.
log: Specifies
to output log information.
trap: Specifies
to output trap information.
debug: Specifies
to output debugging 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 debugging 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 information, 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.
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 debugging information collection may result in a command prompt echoed after
each item of debugging information. To avoid unnecessary output, it is
recommended to 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
Syntax
info-center switch-on { unit unit-id | master | all } [ debugging
| logging | trapping ]*
undo info-center switch-on { unit unit-id | master | all } [ debugging
| logging | trapping ]*
View
System view
Parameter
unit unit-id:
Specifies a switch on which information output function
is to be enabled/disabled.
master: Controls the switch that serves as master.
all: Controls all switches within the fabric.
debugging: Enables the debugging information output source.
logging: Enables the log information output source.
trapping: Enables the trap information output source.
Description
Use the info-center switch-on command
to enable information output function for a specified switch in a fabric.
Use the undo info-center switch-on command
to disable the corresponding information output function for a switch.
By default, debugging information output is
enabled and log and trap information output is disabled for the master switch
in the fabric. Debugging, log and trap information output for other switches is
disabled in the fabric.
After the switches supporting IRF form a
fabric, the log, debugging and trap information of each switch in the fabric
can be synchronized. Each switch sends its own information to other switches in
the fabric and receives information sent by other switches at the same time to
update the information on itself. In this way, the switch ensures the
synchronization of log, debugging and trap information in the whole fabric.
The switch provides command lines to enable
or disable information output for each switch. If you disable information
output for a switch, the switch will no longer send information to other
switches, but still receive information sent by other switches.
You can enable or disable a specified type
of information output for a specified switch as required.
Example
# Enable trap information output for the
switch whose Unit ID is 2 in the fabric.
<H3C> system-view
System View: return to User View with
Ctrl+Z.
[H3C] info-center switch-on unit 2
trapping
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
debugging 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 “Mmm dd hh:mm:ss:ms
yyyy” for English environment and “yyyy/mm/dd-hh:mm:ss:ms”
for Chinese 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/debugging 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 debugging
information.
<H3C> system-view
System View: return to User View with
Ctrl+Z.
[H3C] info-center timestamp debugging
boot
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 “Mmm dd hh:mm:ss:ms
yyyy” for English environment and “yyyy/mm/dd-hh:mm:ss:ms”
for Chinese environment.
no-year-date:
Specifies to adopt the current system date and time excluding the year, which
is in format “Mmm dd hh:mm:ss:ms” for English environment and “mm/dd-hh:mm:ss:ms”
for Chinese environment.
none: Specifies
not to include time stamp in output 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
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 1,024 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 output information
to the trap buffer.
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
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
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
Syntax
terminal debugging
undo terminal debugging
View
User view
Parameter
None
Description
Use the terminal debugging command
to enable debugging terminal display.
Use the undo terminal debugging
command to disable debugging terminal display.
By default, debugging terminal display is
disabled.
You can execute the terminal debugging
command to display debugging information on a user terminal.
Related command: debugging commands
in the System Maintenance and Debugging module of the manual.
Example
# Enable debugging terminal display.
<H3C> terminal debugging
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
Syntax
terminal monitor
undo terminal monitor
View
User view
Parameter
None
Description
Use the terminal monitor command to
enable the debugging/log/trap terminal display function.
Use the undo terminal monitor command
to disable the function.
By default, this function is enabled for console
users and terminal users.
This command works only on the current terminal.
The debugging/log/trap information can be output on the current terminal only
after the command is executed in user view. 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 debugging/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
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
