- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
03-Data buffer commands | 125.64 KB |
buffer packet-drop alarm enable
buffer packet-drop alarm interval
buffer threshold alarm interval
buffer usage threshold headroom
buffer usage threshold headroom queue
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
display buffer usage interface
Data buffer commands
Basic data buffer commands
Inappropriate data buffer changes can cause system problems. Before manually changing data buffer settings, make sure you understand its impact on your device. As a best practice, use the burst-mode enable command if the system requires large buffer spaces. The burst-mode enable command and the buffer apply command are mutually exclusive. If you have configured the data buffer by using one command, you must execute the undo form of the command before using the other command.
buffer apply
Use buffer apply to apply manually configured data buffer settings.
Use undo buffer apply to restore the default.
Syntax
buffer apply
undo buffer apply
Views
System view
Predefined user roles
network-admin
Usage guidelines
For data buffer settings to take effect, you must execute this command after configuring data buffer settings.
After applying manually configured data buffer settings, you cannot directly modify the applied settings. To modify them, you must cancel the application, reconfigure data buffer settings, and reapply the new settings.
On an S6820 switch, this command might cause the PFC function to be on longer in effect or to operate incorrectly. For information about PFC configuration commands, see Ethernet interface commands in Layer 2—LAN Switching Command Reference.
Examples
# Apply manually configured data buffer settings.
<Sysname> system-view
[Sysname] buffer apply
buffer packet-drop alarm enable
Use buffer packet-drop alarm enable to enable packet-drop alarms.
Use undo buffer packet-drop alarm enable to disable packet-drop alarms.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer packet-drop alarm enable
undo buffer packet-drop alarm enable
Default
Packet-drop alarms are disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The device generates and reports packet-drop alarms to a network management system (such as IMC) for displaying the data buffer usage.
This command does not take effect only on the Headroom buffer.
Examples
# Enable packet-drop alarms.
<Sysname> system-view
[Sysname] buffer packet-drop alarm enable
Related commands
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
buffer packet-drop alarm interval
buffer packet-drop alarm interval
Use buffer packet-drop alarm interval to set the interval for sending packet-drop alarms.
Use undo buffer packet-drop alarm interval to restore the default.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer packet-drop alarm interval interval
undo buffer packet-drop alarm interval
Default
The interval for sending packet-drop alarms is 5 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for sending packet-drop alarms, in the range of 0 to 60 seconds. The value of 0 indicates that packet-drop alarms are sent immediately after they are generated.
Usage guidelines
This command takes effect only when packet-drop alarms are enabled.
Examples
# Set the interval for sending packet-drop alarms to 20 seconds.
<Sysname> system-view
[Sysname] buffer packet-drop alarm interval 20
Related commands
buffer packet-drop alarm enable
buffer queue guaranteed
Use buffer queue guaranteed to set the fixed-area space for a queue.
Use undo buffer queue guaranteed to delete the fixed-area space setting of a queue.
Syntax
buffer egress [ slot slot-number ] cell queue queue-id guaranteed ratio ratio
undo buffer egress [ slot slot-number ] cell queue queue-id guaranteed
Default
The fixed-area ratio for a queue is 13%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command applies to all IRF member devices.
cell: Specifies cell resources.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the fixed-area space ratio, in percentage. The value range for ratio is 1 to 100.
Usage guidelines
By default, all queues have an equal share of the fixed area. You can set the fixed-area ratio for a queue. The other queues equally share the remaining part.
The fixed-area space for a queue cannot be used by other queues. Therefore, it is also called the minimum guaranteed buffer for the queue. The sum of fixed-area space configured for all queues cannot exceed the total fixed-area space. Otherwise, the configuration fails.
Examples
# Configure queue 0 to use 20% fixed-area space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] buffer egress cell queue 0 guaranteed ratio 20
buffer queue shared
Use buffer queue shared to set the maximum shared-area ratio for a queue.
Use undo buffer queue shared to delete the maximum shared-area ratio setting of a queue.
Syntax
buffer egress [ slot slot-number ] cell queue queue-id shared ratio ratio
undo buffer egress [ slot slot-number ] cell queue queue-id shared
Default
The maximum shared-area ratio for a queue is 88%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command applies to all IRF member devices.
cell: Specifies cell resources.
queue-id: Specifies a queue by its ID in the range of 0 to 7. If you do not specify a queue, this command sets the maximum shared-area space for each port.
ratio ratio: Specifies the maximum shared-area space ratio, in percentage. The value range for ratio is 0 to 100.
Usage guidelines
By default, all queues have an equal share of the shared area. You can set the shared-area ratio for a queue. The unconfigured queues use the default setting. The shared-area space for each queue is finally determined by the chip based on your configuration and the number of packets to be received and sent.
Examples
# Configure queue 0 to use up to 10% shared-area space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] buffer egress cell queue 0 shared ratio 10
buffer threshold alarm enable
Use buffer threshold alarm enable to enable threshold-crossing alarms.
Use undo buffer threshold alarm enable to disable threshold-crossing alarms.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer threshold alarm { egress | headroom | ingress } enable
undo buffer threshold alarm { egress | headroom | ingress } enable
Default
Threshold-crossing alarms are disabled.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
headroom: Specifies the Headroom buffer.
egress: Specifies the egress buffer.
Usage guidelines
The device generates and reports threshold-crossing alarms to a network management system (such as IMC) for displaying the data buffer usage.
Examples
# Enable threshold-crossing alarms.
<Sysname> system-view
[Sysname] buffer threshold alarm ingress enable
Related commands
buffer usage threshold headroom
buffer usage threshold headroom queue
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
buffer threshold alarm interval
Use buffer threshold alarm interval to set the interval for sending threshold-crossing alarms.
Use undo buffer threshold alarm interval to restore the default.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer threshold alarm { egress | headroom | ingress } interval interval
undo buffer threshold alarm { egress | headroom | ingress } interval
Default
The interval for sending threshold-crossing alarms is 5 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
headroom: Specifies the Headroom buffer.
egress: Specifies the egress buffer.
interval: Specifies the interval for sending threshold-crossing alarms, in the range of 0 to 60 seconds. The value of 0 indicates that threshold-crossing alarms are sent immediately after they are generated.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled.
Examples
# Set the interval for sending threshold-crossing alarms to 20 seconds.
<Sysname> system-view
[Sysname] buffer threshold alarm ingress interval 20
Related commands
buffer threshold alarm enable
buffer usage threshold headroom
buffer usage threshold headroom queue
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
buffer total-shared
Use buffer total-shared to set the total shared-area ratio.
Use undo buffer total-shared to delete the total shared-area ratio setting.
Syntax
buffer egress [ slot slot-number ] cell total-shared ratio ratio }
undo buffer egress [ slot slot-number ] cell total-shared
Default
On an S6800, S6860, or S6861 switch, the total shared-area ratio is 99%.
On an S6820 switch, the total shared-area ratio is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command applies to all IRF member devices.
cell: Specifies cell resources.
ratio ratio: Specifies the ratio of the shared area, in percentage. The value range for ratio is 0 to 100.
Usage guidelines
After you set the shared-area ratio, the remaining buffer space is automatically assigned to the fixed area.
Examples
# Configure the shared area to use 50% space of cell resources in the egress buffer.
<Sysname> system-view
[Sysname] buffer egress cell total-shared ratio 50
buffer usage threshold
Use buffer usage threshold to set a per-interface buffer usage threshold.
Use undo buffer usage threshold to restore the default.
Syntax
buffer usage threshold slot slot-number ratio ratio
undo buffer usage threshold slot slot-number
Default
On an S6800, S6860, or S6861 switch, the per-interface buffer usage threshold is 30%.
On an S6820 switch, the per-interface buffer usage threshold is 70%.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID.
ratio ratio: Specifies the buffer usage threshold in percentage, in the range of 1 to 100.
Usage guidelines
After you configure this command, the switch automatically records buffer usage for each interface. When a queue on an interface uses more buffer space than the set threshold, the system counts one threshold violation for the queue.
To display the buffer usage statistics for interfaces, use the display buffer usage interface command.
Examples
# Set the per-interface buffer usage threshold to 50% for IRF member device 1.
<Sysname> system-view
[Sysname] buffer usage threshold slot 1 ratio 50
Related commands
display buffer usage interface
buffer usage threshold headroom
Use buffer usage threshold headroom to set the global per-queue alarm threshold for the Headroom buffer.
Use undo buffer usage threshold headroom to restore the default.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer usage threshold headroom slot slot-number ratio ratio
undo buffer usage threshold headroom slot slot-number ratio
Default
The global per-queue alarm threshold for the Headroom buffer is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number).
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global alarm threshold for the Headroom buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the global per-queue alarm threshold to 50% for slot 1.
<Sysname> system-view
[Sysname] buffer usage threshold headroom slot 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold headroom queue
Use buffer usage threshold headroom queue to set the Headroom buffer alarm threshold for a queue on an interface.
Use undo buffer usage threshold headroom queue to restore the default.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer usage threshold headroom queue queue-id ratio ratio
undo buffer usage threshold headroom queue queue-id ratio
Default
The global per-queue alarm threshold for the Headroom buffer is used.
Views
Interface view
Predefined user roles
network-admin
Parameters
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the Headroom buffer alarm threshold to 50% for queue 1 on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname–GigabitEthernet1/0/1] buffer usage threshold headroom queue 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold queue (interface view)
Use buffer usage threshold queue to set the ingress or egress buffer alarm threshold for a queue on an interface.
Use undo buffer usage threshold queue to restore the default.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer { egress | ingress } usage threshold queue queue-id ratio ratio
undo buffer { egress | ingress } usage threshold queue queue-id ratio
Default
The global per-queue alarm threshold for the ingress or egress buffer is used.
Views
Interface view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
egress: Specifies the egress buffer.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the alarm threshold for the ingress or egress buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the ingress buffer alarm threshold to 50% for queue 1 on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname–GigabitEthernet1/0/1] buffer ingress usage threshold queue 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold queue (system view)
Use buffer usage threshold queue to set the global ingress or egress buffer alarm threshold for a queue.
Use undo buffer usage threshold queue to restore the default.
|
NOTE: The S6820 switch series does not support this command. |
Syntax
buffer { egress | ingress } usage threshold slot slot-number queue queue-id ratio ratio
undo buffer { egress | ingress } usage threshold slot slot-number queue queue-id ratio
Default
The global ingress or egress buffer alarm threshold for a queue is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
egress: Specifies the egress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number).
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global ingress or egress alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the global ingress alarm threshold to 50% for queue 1 in slot 1.
<Sysname> system-view
[Sysname] buffer ingress usage threshold slot 1 queue 1 ratio 50
Related commands
buffer threshold alarm enable
burst-mode enable
Use burst-mode enable to enable the Burst feature.
Use undo burst-mode enable to disable the Burst feature.
Syntax
burst-mode enable
undo burst-mode enable
Default
The Burst feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The Burst feature is especially useful for reducing packet losses under the following circumstances:
· Broadcast or multicast traffic is intensive, resulting in bursts of traffic.
· Traffic enters a device from a high-speed interface and goes out of a low-speed interface.
· Traffic enters a device from multiple same-rate interfaces and goes out of an interface with the same rate.
On an S6820 switch, disabling the Burst feature after enabling it might cause the PFC function to be on longer in effect or to operate incorrectly. For information about PFC configuration commands, see Ethernet interface commands in Layer 2—LAN Switching Command Reference.
Examples
# Enable the Burst feature.
<Sysname> system-view
[Sysname] burst-mode enable
display buffer
Use display buffer to display buffer size settings.
Syntax
display buffer [ slot slot-number ] [ queue [ queue-id ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command displays buffer size settings for all IRF member devices.
queue queue-id: Specifies a queue by its number in the range of 0 to 7. If you specify a queue, this command displays the fixed-area ratio and shared-area ratio for the specified queue. If you specify the queue keyword without the queue-id argument, this command displays the fixed-area ratio and shared-area ratio for each queue. If you do not specify the queue keyword, this command displays the total shared-area ratio.
Examples
# Display buffer size settings.
<Sysname> display buffer
Slot Type Eg(Total-shared)
1 cell 99
Eg: Size of the sending buffer
Total-shared: Size of the shared buffer for all ports
Unit: Ratio
# Display the fixed-area ratio and shared-area ratio for the queues.
<Sysname> display buffer queue
Slot Queue Type Eg(Guaranteed , Shared)
1 0-7 cell 13 , 88
Eg: Size of the sending buffer
Guaranteed: Size of the minimum guaranteed buffer per queue
Shared: Size of the maximum shared buffer per queue
Unit: Ratio
Table 1 Command output
Field |
Description |
Type |
Resource type. |
Queue |
Queue ID in the range of 0 to 7. |
Eg |
Egress buffer. |
(Total-shared) |
Total-shared indicates the total shared-area ratio. |
(Guaranteed , Shared) |
· Guaranteed indicates the fixed-area
ratio of a queue. · Shared indicates the shared-area ratio
of a queue. |
display buffer usage
Use display buffer usage to display buffer usage.
Syntax
display buffer usage [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command displays buffer usage for all IRF member devices.
Examples
# Display buffer usage.
<Sysname> display buffer usage
Egress total-shared cell buffer usage on slot 1 :
Total: 16061 KB
Used: 0 KB
Free: 16061 KB
5sec 1min 5min
------------------------------------------------------------------
Block 1 0% 0% 0%
XGE1/0/1 0% 0% 0%
XGE1/0/2 0% 0% 0%
XGE1/0/3 0% 0% 0%
Table 2 Command output
Field |
Description |
Egress total-shared cell buffer usage on slot |
Usage of cell resources in the shared area on an IRF member device. |
XPE |
Only the S6820 switch series supports this field. Type of the data buffer. |
Block |
Only the S6800, S6860, and S6861 switch series support this field. Block where the port resides. The block where the ports on the front panel of the device reside is fixed to Block 1. |
Total |
Total size of the data buffer. |
Used |
Size of used data buffer. |
Free |
Size of free data buffer. |
Global_headroom |
Only the S6820 switch series supports this field. Total headroom size. |
SP |
Only the S6820 switch series supports this field. Service pool. |
headroom_used |
Only the S6820 switch series supports this field. Headroom area usage in KB for the ingress buffer. |
Headroom_peak |
Only the S6820 switch series supports this field. Peak used Headroom area in KB during the time between two executions of the display buffer usage command. |
buffer_used |
Only the S6820 switch series supports this field. Used buffer size in KB. |
5sec |
Percentage of the buffer that the port uses for the last 5 seconds. |
1min |
Percentage of the buffer that the port uses for the last 1 minute. |
5min |
Percentage of the buffer that the port uses for the last 5 minutes. |
display buffer usage interface
Use display buffer usage interface to display buffer usage statistics for interfaces.
Syntax
display buffer usage interface [ interface-type [ interface-number ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type [ interface-number ]: Specifies an interface by its type and number. If you do not specify the interface-type argument, this command displays buffer usage statistics for all Ethernet interfaces. If you specify the interface-type argument without the interface-number argument, this command displays buffer usage statistics for all Ethernet interfaces of the specified type.
verbose: Displays detailed buffer usage statistics. If you do not specify this keyword, the command displays brief buffer usage statistics.
Examples
# Display brief buffer usage statistics for Ten-GigabitEthernet 1/0/1.
<Sysname> display buffer usage interface ten-gigabitethernet 1/0/1
Interface QueueID Total Used Threshold(%) Violations
--------------------------------------------------------------------------------
GE1/0/1 0 9418032 0 30 0
1 9418032 0 30 0
2 9418032 0 30 0
3 9418032 0 30 0
4 9418032 0 30 0
5 9418032 0 30 0
6 9418032 0 30 0
7 9418032 0 30 0
Table 3 Command output
Field |
Description |
Total |
Data buffer size in bytes allowed for a queue. |
Used |
Data buffer size in bytes that has been used by a queue. |
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
# Display detailed buffer usage statistics for Ten-GigabitEthernet 1/0/1.
[Sysname] display buffer usage interface ten-gigabitethernet 1/0/1 verbose
Ten-GigabitEthernet1/0/1
Ingress:
QueueID: 0
Total: 0 Used: 0 Threshold(%): 30
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 0 IsDynamic: 0
Used(%): 0 Free: 0 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
...
QueueID: 7
Total: 75143 Used: 0 Threshold(%): 30
Violations: 0 Shared: 0 Headroom: 0
XoffThres: 0 IsDynamic: 0
Used(%): 0 Free: 0 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 0 HeadroomPeak: 0
Egress:
QueueID: 0
Total: 14606384 Used: 0 Threshold(%): 30
Violations: 0 TailDropThres: 0 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 0 UsedPeak: 0
...
QueueID: 7
Total: 14606384 Used: 0 Threshold(%): 30
Violations: 0 TailDropThres: 0 IsDynamic: 1
DeadlockCount: 0 DeadlockRecover: 0
Used(%): 0 Free: 0 UsedPeak: 0
Table 4 Command output
Field |
Description |
Ingress |
Usage statistics for the ingress buffer. |
Egress |
Usage statistics for the egress buffer. |
Total |
Data buffer size allowed for a queue, in bytes for the ingress buffer and in cell resources for the egress buffer. |
Used |
Data buffer size that has been used by a queue, in bytes for the ingress buffer and in cell resources for the egress buffer. |
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
Shared |
Size of the shared area that has been used by a queue, in bytes for the ingress buffer and in cell resources for the egress buffer. |
Headroom |
Number of cell resources in the Headroom area used by a queue. When a queue on an interface enabled with PFC enters PFC XOFF state, the interface sends XOFF frames to notify the peer interface to stop sending packets to that queue. Packets sent by the peer interface before it receives XOFF frames are stored in the Headroom area. |
XoffThres |
Back pressure frame triggering threshold in number of cell resources. |
TailDropThres |
Tail drop threshold, in the number of cell resources calculated according to the ratio value set in the buffer queue shared command. |
IsDynamic |
For the inbound direction, this field can be one of the following values: · 0—Indicates a static back pressure frame triggering threshold. · 1—Indicates a dynamic back pressure frame triggering threshold. For the outbound direction, this field can only be 1, which indicates a dynamic tail drop threshold. |
Used(%) |
Buffer usage in percentage. |
Free |
Free space in bytes for the ingress buffer and in cell resources for the egress buffer. |
UsedPeak |
Peak used buffer during the time between two executions of the display buffer usage interface command. The unit of the peak used buffer is byte for the ingress buffer and cell resource for the egress buffer. |
HeadroomUsed(%) |
Headroom area usage in percentage for the ingress buffer. |
HeadroomFree |
Free Headroom area in number of cell resourcesfor the ingress buffer. |
HeadroomPeak |
Peak used Headroom area in number of cell resourcesduring the time between two executions of the display buffer usage interface command. |
DeadlockCount |
Number of times the device entered the PFC deadlock state in the egress buffer. |
DeadlockRecover |
Number of times the device released the PFC deadlock state in the egress buffer. |
|
NOTE: For more information about back pressure frame triggering thresholds and PFC deadlock, see Ethernet interface configuration in Layer 2—LAN Switching Configuration Guide. |
FMA commands
Only the S6800 switch series supports FMA.
fma agent-ip
Use fma agent-ip to configure the agent's IP address.
Syntax
fma agent-ip agent-ip
Default
No IP address is configured for an agent.
Views
System view
Predefined user roles
network-admin
Parameters
agent-ip: Specifies the IP address.
Examples
# Configure the agent's IP address as 1.1.1.1.
<Sysname> system-view
[Sysname] fma agent-ip 1.1.1.1
fma agent-mac
Use fma agent-mac to configure the agent's MAC address.
Syntax
fma agent-mac agent-mac
Default
No MAC address is configured for an agent.
Views
System view
Predefined user roles
network-admin
Parameters
agent-mac: Specifies the MAC address.
Examples
# Configure the agent's MAC address as 0000-0001-0002.
<Sysname> system-view
[Sysname] fma agent-mac 0000-0001-0002
fma agent-port
Use fma agent-port to configure the agent's port number.
Syntax
fma agent-port agent-port
Default
No port number is configured for an agent.
Views
System view
Predefined user roles
network-admin
Parameters
agent-port: Specifies the port number in the range of 0 to 65535.
Examples
# Configure the agent's port number as 8080.
<Sysname> system-view
[Sysname] fma agent-port 8080
fma client-ip
Use fma client-ip to specify the client's IP address.
Syntax
fma client-ip client-ip
Default
The client's IP address is not specified.
Views
System view
Predefined user roles
network-admin
Parameters
client-ip: Specifies the IP address.
Usage guidelines
The specified IP address must be the IP address actually used by the client.
Examples
# Specify the client's IP address as 1.1.1.1.
<Sysname> system-view
[Sysname] fma client-ip 1.1.1.1
fma client-port
Use fma client-port to specify the client's port number.
Syntax
fma client-port client-port
Default
The client's port number is not specified.
Views
System view
Predefined user roles
network-admin
Parameters
client-port: Specifies the port number in the range of 0 to 65535.
Usage guidelines
The specified port number must be the port number actually used by the client.
Examples
# Specify the client's port number as 8080.
<Sysname> system-view
[Sysname] fma client-port 8080
fma enable
Use fma enable to enable the FMA feature.
Use undo fma enable to disable the FMA feature.
Syntax
fma enable
undo fma enable
Default
The FMA feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The Fabric Monitor and Analyzer (FMA) feature works with IMC to perform device monitoring and analysis. The switch acts as an FMA agent, and the IMC server acts as an FMA client. The FMA-related commands do not take effect after you configure them on the FMA agent. You must configure the following settings on the FMA client:
· Agent's IP address, MAC address, and port number.
· Client's IP address and port number.
After you configure these settings and enable the Microburst feature on the FMA client, the FMA agent automatically receives these settings from the FMA client.
After the FMA agent receives these settings, it can exchange device monitoring and analysis information with the FMA client.
In the current software version, this feature supports only data buffer statistics and detection. Data buffer statistics are buffer usage statistics for queues. Data buffer detection information is the buffer usage threshold for queues.
Examples
# Enable the FMA feature.
<Sysname> system-view
[Sysname] fma enable