Chapter 1 Information Center Configuration Commands
1.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 in the command,
the settings of all channels are displayed.
Example
# Display the settings of information
channel 0.
<Sysname> 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 of the device, the value can only be 1.
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.
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, 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.
<Sysname> 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, overwritten
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, overwritten
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
|
|
Information
Center
|
Status of the
information center: enabled/disabled
|
|
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 number of its information channel
|
|
Monitor
|
Information
about the monitor port, including name and number 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, number of dropped messages,
and number of 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, number of dropped messages, and number of overwritten
messages
|
|
Information timestamp setting:
|
Information about the time stamp setting,
showing the time stamp format of the log, trap and debugging information
|
Syntax
display logbuffer [ unit unit-id ] [ level severity | size
buffersize ]* [ | { begin | exclude | include }
regular-expression ]
View
Any view
Parameter
unit-id: Unit
ID of the device, the value can only be 1.
level
severity: Specifies an information severity level. The
severity argument ranges from 1 to 8.
Table 1-2 Severity level defined in the
information center
|
Severity
|
Severity value
|
Description
|
|
emergencies
|
1
|
The system
is unavailable.
|
|
alerts
|
2
|
Information
that demands prompt reaction
|
|
critical
|
3
|
Critical information
|
|
errors
|
4
|
Error information
|
|
warnings
|
5
|
Warnings
|
|
notifications
|
6
|
Normal information that needs to be
noticed
|
|
informational
|
7
|
Informational information to be recorded
|
|
debugging
|
8
|
Information generated during debugging
|
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 line that matches the regular expression and all the subsequent lines.
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.
<Sysname> 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
%Jun 19 18:03:24:55 2006 Sysname
IC/7/SYS_RESTART:
System restarted --
The rest is omitted here.
Table 1-3
display logbuffer
command output description
|
Field
|
Description
|
|
Logging buffer configuration and contents
|
Indicates the current state of the log
buffer and its contents, which could be enabled or disabled.
|
|
Allowed max buffer size
|
The maximum buffer size allowed
|
|
Actual buffer size
|
The actual buffer size
|
|
Channel number
|
The channel number of the log buffer,
defaults to 4.
|
|
Channel name
|
The channel name of the log buffer,
defaults to logbuffer.
|
|
Dropped messages
|
The number of dropped messages
|
|
Overwritten messages
|
The number of overwritten messages (when
the buffer size is not big enough to hold all messages, the latest messages
overwrite the old ones).
|
|
Current messages
|
The number of the current messages
|
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.
<Sysname> display logbuffer
summary
EMERG ALERT CRIT ERROR WARN NOTIF
INFO DEBUG
0 0 0 0 94
0 1 0
The above information indicates that there
are 94 warnings and one informational information in the log buffer.
Syntax
display trapbuffer [ unit unit-id ] [ size buffersize ]
View
Any view
Parameter
unit-id: Unit
ID of the device, the value can only be 1.
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.
Absence of the size buffersize argument
indicates that all trap information is displayed.
Example
# Display the status of the trap buffer and
the records in the trap buffer.
<Sysname> 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
Overwritten messages : 0
Current messages : 6
#Apr 1 23:55:52:263 2006 Sysname
L2INF/2/PORT LINK STATUS CHANGE:- 1 -
Trap 1.3.6.1.6.3.1.1.5.4(linkUp):
portIndex is 4227641, ifAdminStatus is 1, ifOperStatus is 1
#Apr 2 00:17:47:875 2006 Sysname
L2INF/2/PORT LINK STATUS CHANGE:- 1 -
Trap 1.3.6.1.6.3.1.1.5.3(linkDown):
portIndex is 4227833, ifAdminStatus is 2, ifOperStatus is 2
……
<Omitted>
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.
Do not configure two different channels
with the same name.
Example
# Name channel 0 as
“execconsole”.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] 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 through which system information is
output to the console.
By default, output of information to the
console is enabled with channel 0 as the default channel (known as console).
This command works only when the information
center is enabled.
Related command: info-center enable and
display info-center.
Example
# Configure to output information to the
console through channel 0.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname]
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, info-center snmp channel.
Example
# Enable the information center.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] info-center enable
% Information center is enabled
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 information output to the log buffer.
By default, information output to the log
buffer is enabled with channel 4 (logbuffer) as the default channel and a
maximum buffer size of 512.
This command works only when the information
center is enabled.
Related command: info-center enable,
display info-center.
Example
# Configure the system to output
information to the log buffer with the size of 50.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] info-center logbuffer size 50
Syntax
info-center loghost host-ip-addr [ channel
{ channel-number | channel-name } | facility
local-number ]*
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
local-number: Specifies the logging
facility of the log host, which ranges from local0 to local7, with the
corresponding value ranging from 16 to 23; and defaults to local7, with the
corresponding value being 23.
Description
Use the info-center loghost command
to enable information output to a log host through specifying the IP address of
the log host.
Use the undo info-center loghost
command to disable information output to the log host.
By default, the switch does not output information
to the log host. When it is enabled, the default channel name will be loghost
and the default channel number will be 2.
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, display info-center.
Example
# Configure the system to output system information
to the Unix log host whose IP address is 202.38.160.1.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] 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,
display info-center.
Example
# Configure VLAN-interface 1 as the source
interface through which information is sent to the log host.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] 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 default channel through
which information is output to user terminals.
By default, output of system information to
the monitor is enabled with a default channel name of monitor and a default
channel number of 1.
This command works only when the information
center is enabled.
Related command: info-center enable,
display info-center.
Example
# Set the system to output information to
user terminals through channel 0.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] 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.
By default, output of system information to
the SNMP NMS is enabled with a default channel name of snmpagent and a default
channel number of 5.
Related command: snmp-agent, display
info-center.
Example
# Set the switch to output information to
the SNMP agent through channel 6.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname] 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 severity:
Specifies an information severity level. For the value of severity,
refer to Table 1-2.
state state: Configures whether to output the system information. The value of state
can be on (enabled) or off (disabled).
Description
Use the info-center source command
to specify the output rules of the system information.
Use the undo info-center source command
to remove the specified output rules.
By default, the output rules for the system
information are listed in Table
1-4.
This command can be used to set the filter
and redirection rules of log, trap and debugging information.
For example, the user can set to output log
information with severity higher than warnings to the log host, and information
with severity higher than informational to the log buffer. The user can also
set to output trap information of the IP module to a specified output
destination.
Note that:
l
If you do not use the module-name
argument to set output rules for a module, the module uses the default output
rules or the output rules set by the default keyword; otherwise, the
module uses the output rules separately set for it.
l
If you use the module-name argument to
set the output rules for a module without specifying the debug, log,
and trap keywords, the default output rules for the module are as
follows: the output of log and trap information is enabled, with severity being
informational; the output of debugging information is disabled, with severity
being debugging. For example, if you execute the command info-center source
snmp channel 5, the command is actually equal to the command info-center
source snmp channel 5 debug level debugging state off log level informational
state on trap level informational state on.
l
After you separately set the output rules for a
module, you must use the module-name argument to modify or remove the
rules. The new configuration by using the default keyword is invalid on
the module.
l
You can configure to output the log, trap and
debugging information to the trap buffer, but the trap buffer only receives the
trap information and discards the log and debugging information.
l
You can configure to output the log, trap and
debugging information to the log buffer, but the log buffer only receives the
log and debugging information and discards the trap information.
l
You can configure to output the log, trap and
debugging information to the SNMP module, but the SNMP module only receives the
trap information and discards the log and debugging information.
Table 1-4 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
|
|
Monitor 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 module
|
default (all modules)
|
Disabled
|
debugging
|
Enabled
|
warnings
|
Disabled
|
debugging
|
|
Log file
|
default (all modules)
|
Enabled
|
debugging
|
Enabled
|
debugging
|
Disabled
|
debugging
|
Examples
# Set the
output channel for the log information of VLAN module to snmpagent and
to output information with severity being emergencies. Log information
of other modules cannot be output to this channel.
<Sysname>
system-view
[Sysname]
info-center source default channel snmpagent log state off
[Sysname] info-center source vlan
channel snmpagent log level emergencies state on
# Set the output channel for the log
information of VLAN module to snmpagent and to output information with
severity being emergencies. Log information of other modules and all the
other system information cannot be output to this channel.
<Sysname> system-view
[Sysname] info-center source default
channel snmpagent debug state off log state off trap state off
[Sysname] info-center source vlan
channel snmpagent log level emergencies state on
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 information output, so that if system
information (such as log information) is output when the user is inputting
information, the command prompt and the 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 information output.
By default, the synchronous information output
function is disabled.
l
The synchronous information output function is
used in the case that your input is interrupted by a large amount of system
output. With this function enabled, the system echoes your previous input and
you can continue your operations from where you were stopped.
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 information output in such case.
Example
# Enable synchronous information output.
<Sysname> system-view
System View: return to User View with
Ctrl+Z.
[Sysname]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
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: The
current system date and time, in the format of “Mmm dd hh:mm:ss:sss yyyy”.
l
Mmm: The abbreviations of the months in English,
which could be Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, or Dec.
l
dd: The date, starting with a space if less than
10, for example “ 7”.
l
hh:mm:ss:sss: The local time, with hh ranging
from 00 to 23, mm and ss ranging from 00 to 59, and sss ranging from 0 to 999.
l
yyyy: Represents the year.
none: Specifies
not to include time stamp in the 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 setting of time stamp format.
By default, the date time stamp is
adopted for log and trap information, and the boot time stamp is adopted
for debugging information.
