Table of Contents

Chapter 1 NetStream Configuration Commands. 1-1

1.1 NetStream Configuration Commands. 1-1

1.1.1 display ip netstream cache. 1-1

1.1.2 display ip netstream export 1-2

1.1.3 enable. 1-4

1.1.4 interface net-stream.. 1-4

1.1.5 ip netstream.. 1-5

1.1.6 ip netstream aggregation. 1-6

1.1.7 ip netstream binding interface. 1-7

1.1.8 ip netstream export host 1-8

1.1.9 ip netstream export source interface. 1-9

1.1.10 ip netstream export v9-template refresh-rate packet 1-10

1.1.11 ip netstream export v9-template refresh-rate time. 1-11

1.1.12 ip netstream export version. 1-12

1.1.13 ip netstream timeout active. 1-13

1.1.14 ip netstream timeout inactive. 1-14

1.1.15 reset ip netstream statistics. 1-15

 

Chapter 1  NetStream Configuration Commands

 

 

1.1  NetStream Configuration Commands

1.1.1  display ip netstream cache

Syntax

display ip netstream cache

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display ip netstream cache command to view configuration and status information about the NetStream cache.

Examples

# Display information about the NetStream cache on the switch.

<Sysname> display ip netstream cache

Netstream cache information

  Stream active timeout(minute)       : 30

  Stream inactive timeout(second)     : 60

  IP active stream entry              : 0

  MPLS active stream entry            : 0

  IP stream entry been exported       : 0

  MPLS stream entry been exported     : 0

  Last clearing of statistics never

 

 Protocol           Total  Packets   Stream   Packets Active(sec)   Idle(sec)

                  Streams     /Sec     /Sec   /stream     /stream     /stream

 ----------------------------------------------------------------------------

 Total                  0        0         0         0           0           0

Table 1-1 display ip netstream cache command output description

Field	Description
Stream active timeout(minute)	Active aging timer for NetStream cache entries
Stream inactive timeout(second)	Inactive aging time for NetStream cache entries
IP Active stream entry	Number of active NetStream IP streams
MPLS Active stream entry	Number of active NetStream MPLS streams
IP Stream entry been exported	Number of free NetStream IP streams that are counted
MPLS Stream entry been exported	Number of free NetStream MPLS streams that are counted
Last clearing of statistics never	The statistics have never been cleared.
Protocol           Total Streams  Packets /Sec   Stream /Sec   Packets /stream Active(sec) /stream   Idle(sec) /stream	Packet statistics differentiated by protocol type: protocol, total number of streams, number of packets per second, number of streams per second, active time for each stream, inactive time for each stream

 

1.1.2  display ip netstream export

Syntax

display ip netstream export

View

Any view

Default Level

1: Monitor level

Parameters

None

Description

Use the display ip netstream export command to view statistics about exported NetStream statistics packets.

Examples

# Display information about the NetStream cache on the switch.

<Sysname> display ip netstream export

Version 5 IP export information

  Stream source interface                       : Vlan-interface1000

  Stream destination IP(UDP)                    : 192.168.1.200(9991)

  Exported stream number                        : 20

  Exported UDP datagram number(failed number)   : 2(0)

 Version 9 MPLS export information

  Stream source interface                       : Vlan-interface1000

  Stream destination IP(UDP)                    : 192.168.1.200(9991)

  Exported stream number                        : 0

  Exported UDP datagram number(failed number)   : 0(0)

 Version 8 AS aggregation information

  Stream source interface                       :

  Stream destination IP(UDP)                    : 192.168.1.200(9991)

  Exported stream number                        : 0

  Exported UDP datagram number(failed number)   : 0(0)

Table 1-2 display ip netstream export command output description

Field	Description
Version 5 IP export information	Statistics for exported version 5 statistics packets
Stream source interface	Source interface of exported UDP packets
Stream destination IP(UDP)	Destination address and port number of exported UDP packets
Exported stream number	Number of exported streams
Exported UDP datagram number(failed number)	Number of exported UDP packets (number of failed sending attempts)
Version 8 AS aggregation export information	Statistics for exported version 8 AS aggregation UDP packets. Displayed only when NetStream aggregation is enabled.
Version 9 MPLS export information	Statistics for exported version 9 MPLS packets

 

1.1.3  enable

Syntax

enable

undo enable

View

NetStream aggregation view

Default Level

1: Monitor level

Parameters

None

Description

Use the enable command to enable current aggregation mode.

Use the undo enable command to disable current aggregation mode.

By default, no aggregation mode is enabled.

Related commands: ip netstream aggregation.

Examples

# Enable NetStream AS aggregation.

<Sysname> system-view

[Sysname] ip netstream aggregation as

[Sysname-aggregation-as] enable

1.1.4  interface net-stream

Syntax

interface net-stream interface-number

View

System view

Default Level

1: Monitor level

Parameters

interface-number: Specifies a NetStream interface by its number.

Description

Use the interface net-stream command to enter specified NetStream interface view.

An L3 + LPU (line processing unit) is needed for the execution of this command.

Examples

# Enter specified NetStream interface view.

<Sysname> system-view

[Sysname] interface net-stream 1/0/2

[Sysname-Net-Stream1/0/2]

1.1.5  ip netstream

Syntax

ip netstream { inbound | outbound }

undo ip netstream { inbound | outbound }

View

Ethernet interface view

Default Level

3: Manage level

Parameters

inbound: Enables NetStream statistics in the inbound direction of a port.

outbound: Enables NetStream statistics in the outbound direction of a port.

Description

Use the ip netstream command to enable NetStream statistics in the inbound or outbound direction of the current port.

Use the undo ip netstream command to disable Netstream statistics in the inbound or outbound direction of the current port.

By default, NetStream statistics is disabled in both directions of a port.

 

 

Examples

# Enable NetStream statistics in the inbound direction of port Ethernet 1/1/1.

<Sysname> system-view

[Sysname] interface ethernet 1/1/1

[Sysname-Ethernet1/1/1] ip netstream inbound

1.1.6  ip netstream aggregation

Syntax

ip netstream aggregation { as | destination-prefix | prefix | prefix-port | protocol-port | source-prefix | tos-as | tos-destination-prefix | tos-prefix | tos-protocol-port | tos-source-prefix }

View

System view

Default Level

3: Manage level

Parameters

as: AS aggregation by combination of source AS number, destination AS number, inbound interface index, and outbound interface index.

destination-prefix: Destination-prefix aggregation by destination AS number, destination address mask length, destination prefix, and outbound interface index.

prefix: Source and destination prefix aggregation by combination of source AS number, destination AS number, source address mask length, destination address mask length, source prefix, destination prefix, inbound interface index, and outbound interface index.

prefix-port: Prefix-port aggregation by combination of source prefix, destination prefix, source address mask length, destination address mask length, ToS, protocol number, source port, destination port, inbound interface index, and outbound interface index.

protocol-port: Protocol-port aggregation by combination of protocol number, source port, and destination port.

source-prefix: Source-prefix aggregation by combination of source AS number, source address mask length, source prefix, and inbound interface index.

tos-as: ToS-AS aggregation by combination of ToS, source AS number, destination AS

 number, inbound interface index, and outbound interface index.

tos-destination-prefix: ToS-destination-prefix aggregation by ToS, destination AS number, destination address mask length, destination prefix, and outbound interface index.

tos-prefix: ToS-prefix aggregation by combination of ToS, source AS number, source prefix, source address mask length, destination AS number, destination address mask length, destination prefix, inbound interface index, and outbound interface index.

tos-protocol-port: ToS-protocol-port aggregation by combination of ToS, protocol number, source port, destination port, inbound interface index, and outbound interface index.

tos-destination-prefix: ToS-source-prefix aggregation by ToS, source AS number, source prefix, source address mask length, and inbound interface index.

Description

Use the ip netstream aggregation command to enter NetStream aggregation view.

In NetStream aggregation view, you can enable or disable the aggregation mode, set information about source interface, destination IP address and destination port number for version 8 UDP packets.

Related commands: enable, ip netstream export host, ip netstream export source.

Examples

# Enter NetStream AS aggregation view.

<Sysname> system-view

[Sysname] ip netstream aggregation as

[Sysname-aggregation-as]

1.1.7  ip netstream binding interface

Syntax

ip netstream binding interface interface-type interface-number { inbound | outbound }

undo ip netstream binding interface interface-type interface-number { inbound | outbound }

View

NetStream interface view

Default Level

3: Manage level

Parameters

interface-type interface-number: Specifies an interface by its type and number. interface-type can be Ethernet, GigabitEthernet and Ten-GigabitEthernet.

inbound: Specifies the NetStream statistics in the inbound direction of a port.

outbound: Specifies the NetStream statistics in the outbound direction of a port.

Description

Use the ip netstream binding interface command to associate the interface on the NetStream LPU with the specified interface.

Use the undo ip netstream binding interface command to cancel the association.

By default, no interface is bound.

Note that:

l           The command can enable the NetStream statistics function only when it is executed together with the ip netstream inbound command.

l           Multiple interfaces can be bound on a NetStream LPU.

l           The execution of the ip netstream command occupies mirroring resources. If the resources are insufficient, IP NetStream cannot be configured.

 

 

Related commands: ip netstream.

Examples

# Associate the interface GigabitEthernet 6/1/2 with the interface NetStream 3/0/2 on the NetStream LPU.

<Sysname> system-view

[Sysname] interface net-stream 3/0/2

[Sysname-NetStream3/0/2] ip netstream binding interface GigabitEthernet6/1/2 inbound

1.1.8  ip netstream export host

Syntax

ip netstream export host ip-address udp-port

undo ip netstream export host [ ip-address ]

View

System view, NetStream aggregation view

Default Level

3: Manage level

Parameters

ip-address: Destination IP address for NetStream UDP packets.

udp-port: Destination port number for NetStream UDP packets.

Description

Use the ip netstream export host command to set the destination IP address and port number for NetStream UDP packets.

Use the undo ip netstream export host command to restore the default.

By default, no destination IP address and port number are configured in system view and the IP address and port number in aggregation view are those configured by users in system view.

Note that:

l           Different destination hosts can be configured in different aggregation views.

l           You can configure up to two different destination hosts in one aggregation view. Statistics packets for a single stream are sent to all destination hosts configured in system view. Aggregation statistics packets are sent to all destination hosts configured in the aggregation view corresponding to the aggregation type.

Related commands: ip netstream aggregation, ip netstream export source.

Examples

# Configure the destination IP address and port number for NetStream statistics packet as 172.16.105.48 and 5000 respectively.

<Sysname> system-view

[Sysname] ip netstream export host 172.16.105.48 5000

1.1.9  ip netstream export source interface

Syntax

ip netstream export source interface interface-type interface-number

undo ip netstream export source

View

System view, NetStream aggregation view

Default Level

3: Manage level

Parameters

interface-type interface-number: Specifies a source interface for NetStream statistics packets by its type and number.

Description

Use the ip netstream export source interface command to configure the source interface for NetStream statistics packets. The IP address of this interface is used as the source address of UDP packets.

Use the undo ip netstream export source command to remove the configured source interface.

By default, the source interface is the interface of statistics packets, that is, the source address of NetStream statistics packets is used as the IP address for the layer 3 interface that sends packets.

Different source interface addresses can be configured in different aggregation views.

Related commands: ip netstream aggregation.

Examples

# Configure the source interface for NetStream statistics packets as POS 3/1/1.

<Sysname> system-view

[Sysname] ip netstream export source interface pos 3/1/1

1.1.10  ip netstream export v9-template refresh-rate packet

Syntax

ip netstream export v9-template refresh-rate packet packets

undo ip netstream export v9-template refresh-rate packet

View

System view

Default Level

3: Manage level

Parameters

packets: Packet refresh rate of version 9 templates. It is the number of reported packets.

Description

Use the ip netstream export v9-template refresh-rate packet command to configure the packet refresh rate of version 9 templates.

Use the undo ip netstream export v9-template refresh-rate packet command to restore the default packet refresh rate of version 9 templates, that is, 20.

Because of its limited capacity, XLog does not save all version 9 templates for ever; therefore, version 9 templates must be refreshed periodically. You can configure the packet refresh rate of version 9 templates to refresh them on time.

Related commands: ip netstream export v9-template refresh-rate time.

Examples

# Set the packet refresh rate for version 9 templates to 100.

<Sysname> system-view

[Sysname] ip netstream export v9-template refresh-rate packet 100

1.1.11  ip netstream export v9-template refresh-rate time

Syntax

ip netstream export v9-template refresh-rate time minutes

undo ip netstream export v9-template refresh-rate time

View

System view

Default Level

3: Manage level

Parameters

minutes: Specifies the interval to send version 9 templates for NetStream statistics packets, in minutes.

Description

Use the ip netstream export v9-template refresh-rate time command to configure the interval to send version 9 templates for NetStream statistics packets.

Use the undo ip netstream export version command to restore the default interval, that is, 30 minutes.

Because of its limited capacity, XLog does not save all version 9 templates for ever; therefore, version 9 templates must be refreshed periodically. You can configure the interval to send version 9 templates to refresh them on time.

Related commands: ip netstream export v9-template refresh-rate packet.

Examples

# Set the interval to send version 9 templates to 60 minutes.

<Sysname> system-view

[Sysname] ip netstream export v9-template refresh-rate time 60

1.1.12  ip netstream export version

Syntax

ip netstream export version version-number [ origin-as | peer-as ]

undo ip netstream export version

View

System view

Default Level

3: Manage level

Parameters

version-number: Version number for NetStream statistics packets.

origin-as: Sets the type of AS number recorded in NetStream cache entries to origin.

peer-as: Sets the type of AS number recorded in NetStream cache entries to peer.

Description

Use the ip netstream export version command to configure the type of AS numbers to be recorded in NetStream cache entries and the version of NetStream statistics packets.

Use the undo ip netstream export version command to restore the default.

By default, a single stream is sent in version 5 UDP packets, aggregation statistics information is sent in version 8 UDP packets, and MPLS stream information is sent in version 9 UDP packets and the AS option is peer-as.

Note that the AS numbers for the source and destination IP addresses of a stream are recorded in the statistics information. And each IP address corresponds with two AS numbers (origin and peer), the system records the AS numbers according to the AS option configured by users.

Examples

# Set the NetStream statistics packet version number to 5 and the AS option to origin-as.

<Sysname> system-view

[Sysname] ip netstream export version 5 origin-as

1.1.13  ip netstream timeout active

Syntax

ip netstream timeout active minutes

undo ip netstream timeout active

View

System view

Default Level

3: Manage level

Parameters

minutes: Sets the length of the active aging timer for NetStream cache entries, in minutes, in the range 1 to 60.

Description

Use the ip netstream timeout active command to set the active aging timer for NetStream cache entries.

Use the undo ip netstream timeout active command to restore the default.

The active aging timer for NetStream cache entries is 30 minutes by default.

 

 

Related commands: ip netstream timeout inactive.

Examples

# Set the active aging timer to 60 minutes.

<Sysname> system-view

[Sysname] ip netstream timeout active 60

1.1.14  ip netstream timeout inactive

Syntax

ip netstream timeout inactive seconds

undo ip netstream timeout inactive

View

System view

Default Level

3: Manage level

Parameters

seconds: Sets the length of the inactive aging timer for NetStream cache entries, in seconds, in the range 60 to 600.

Description

Use the ip netstream timeout inactive command to set the inactive aging timer for NetStream cache entries.

Use the undo ip netstream timeout inactive command to restore the default.

The inactive aging timer for NetStream cache entries is 60 seconds by default.

 

 

Related commands: ip netstream timeout active.

Examples

# Set the inactive aging timer to 60 seconds.

<Sysname> system-view

[Sysname] ip netstream timeout inactive 60

1.1.15  reset ip netstream statistics

Syntax

reset ip netstream statistics

View

User view

Default Level

2: System level

Parameters

None

Description

Use the reset ip netstream statistics command to age and export all stream statistics to clear the NetStream cache.

Examples

# Age and export all stream statistics to clear the NetStream cache.

<Sysname> reset ip netstream statistics