TWAMP Commands

twamp

Syntax

twamp

Context

config>oam-test

Description

This command enables TWAMP functions. See the clear>test-oam>twamp>server command description for information about how to disable TWAMP functions.

Default

TWAMP is disabled

server

Syntax

server

Context

config>oam-test>twamp

Description

This command configures the TWAMP server.

Default

TWAMP server is disabled

prefix

Syntax

prefix ip-prefix/prefix-length [create]

no prefix ip-prefix/prefix-length

Context

config>test-oam>twamp>server

Description

This command configures an IP address prefix containing one or more TWAMP clients. In order for a TWAMP client to connect to the TWAMP server (and to conduct tests), the client must establish the control connection using an IP address that is part of a configured prefix.

Default

no prefix

Parameters

ip-prefix

IP address

Values

ipv4-address          a.b.c.d (host bits must be 0)

ipv6-address         x:x:x:x:x:x:x:x (eight 16-bit pieces)

                              x:x:x:x:x:x:d.d.d.d

                              x:   [0 to FFFF]H

                              d:   [0 to 255]D

Default

n/a

prefix-length

the prefix length in bits

Values

ipv4-prefix-length          0 to 32

ipv6-prefix-length         0 to 128

Default

n/a

description

Syntax

description description-string

no description

Context

config>test-oam>twamp>server>prefix

Description

This command creates a text description of an IP prefix used by a TWAMP server. The prefix description can be changed at any time, even while the server is running.

The no form of the command removes the description.

Default

no description

Parameters

description-string

the description character string. Allowed values are any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

max-conn-prefix

Syntax

max-conn-prefix count

no max-conn-prefix

Context

config>test-oam>twamp>server>prefix

Description

This command configures the maximum number of control connections by clients with an IP address in a specific prefix. A new control connection is rejected if accepting it would cause either the prefix limit defined by this command or the server limit (max-conn-server) to be exceeded.

The no form of the command sets the default value.

Default

no max-conn-prefix

Parameters

count

the maximum number of control connections

Values

0 to 64

Default

32

max-sess-prefix

Syntax

max-sess-prefix count

no max-sess-prefix

Context

config>test-oam>twamp>server>prefix

Description

This command configures the maximum number of concurrent TWAMP test sessions by clients with an IP address in a specific prefix. A new test session (described by a Request-TW-Session message) is rejected if accepting it would cause either the limit defined by this command or the server limit (max-sess-server) to be exceeded.

The no form of the command sets the default value (32).

Default

no max-sess-prefix

Parameters

count

the maximum number of concurrent test sessions

Values

0 to 128

Default

32

inactivity-timeout

Syntax

inactivity-timeout timer

no inactivity-timeout

Context

config>test-oam>twamp>server

Description

This command configures the inactivity timeout for all TWAMP control connections. If no TWAMP control message is exchanged over the TCP connection for this time, the connection is closed and all in-progress tests are terminated.

The no form of the command sets the default value.

Default

no inactivity-timeout

Parameters

timer

the duration of the inactivity timeout, in seconds

Values

60 to 3600

Default

900

max-conn-server

Syntax

max-conn-server count

no max-conn-server

Context

config>test-oam>twamp>server

Description

This command configures the maximum number of TWAMP control connections from all TWAMP clients. A new control connection is rejected if accepting it would cause either this limit or a prefix limit (max-connprefix) to be exceeded.

The no form of the command sets the default value.

Default

no max-conn-server

Parameters

count

the maximum number of control connections

Values

0 to 64

Default

32

max-sess-server

Syntax

max-sess-server count

no max-sess-server

Context

config>test-oam>twamp>server

Description

This command configures the maximum number of concurrent TWAMP test sessions across all allowed clients. A new test session (described by a Request-TW-Session message) is rejected if accepting it would cause either the limit defined by this command or a prefix limit (max-sess-prefix) to be exceeded.

The no form of the command sets the default value.

Default

no max-sess-server

Parameters

count

the maximum number of concurrent test sessions

Values

0 to 128

Default

32

ref-inactivity-timeout

Syntax

ref-inactivity-timeout timer

no ref-inactivity-timeout

Context

config>test-oam>twamp>server

Description

This command configures the reflector inactivity timeout for all TWAMP test connections. If no TWAMP test frame is received for the timer duration, then the existing TWAMP test connections are closed.

The no form of the command sets the timer value to its default value of 900 seconds.

Default

no ref-inactivity-timeout

Parameters

timer

the duration of the ref-inactivity timeout, in seconds

Values

60 to 3600

Default

900

twamp-light

Syntax

twamp-light

Context

config>test-oam>twamp

Description

This command enables the context for configuring TWAMP Light functionality.

Default

disabled

inactivity-timeout

Syntax

inactivity-timeout seconds

no inactivity-timeout

Context

config>test-oam>twamp>twamp-light

Description

This command configures the length of time that a stale state is maintained on the session reflector. A stale state is test data that has not been refreshed or updated by newly arriving queries for a specific test for a configured length of time. Any single reflector can maintain an Up state for a maximum of 12 000 tests. If the maximum value is exceeded, the session reflector does not have memory to allocate to new tests; therefore, stale test data should be deleted to ensure that there is room for new tests.

The no form of the command sets the default value.

Default

no inactivity-timeout

Parameters

time

the number of seconds that a stale state is maintained

Values

10 to 100

Default

100