SDP keepalive commands

keep-alive

Syntax

keepalive

Context

config>service>sdp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context configure SDP connectivity monitoring keepalive messages for the SDP ID.

SDP-ID keepalive messages use SDP Echo Request and Reply messages to monitor SDP connectivity. The operating state of the SDP is affected by the keepalive state on the SDP-ID. SDP Echo Request messages are sent only when the SDP-ID is completely configured and administratively up. If the SDP-ID is administratively down, keepalives for that SDP-ID are disabled. SDP Echo Requests (when sent for keepalive messages) are always sent with the originator-sdp-id. All SDP-ID keepalive SDP Echo Replies are sent using generic IP OAM encapsulation.

When a keepalive response is received that indicates an error condition, the SDP ID is immediately brought operationally down. When a response is received that indicates the error has cleared and the hold-down-time interval has expired, the SDP ID is eligible to be put into the operationally up state. If no other condition prevents the operational change, the SDP ID enters the operational state.

A set of event counters track the number of keepalive requests sent, the size of the message sent, non-error replies received, and error replies received. A keepalive state value is kept indicating the last response event. A keepalive state timestamp value is kept indicating the time of the last event. With each keepalive event change, a log message is generated indicating the event type and the timestamp value.

The following table describes the keepalive interpretation of SDP echo reply response conditions and the effect on the SDP ID operational status.

Table: SDP echo reply response conditions
Result of request Stored response state Operational state

keepalive request timeout without reply

Request Timeout

Down

keepalive request not sent because of non-existent orig-sdp-id1

Orig-SDP Non-Existent

Down

keepalive request not sent because of administratively down orig-sdp-id

Orig-SDP Admin-Down

Down

keepalive reply received, invalid origination-id

Far End: Originator-ID Invalid

Down

keepalive reply received, invalid responder-id

Far End: Responder-ID Error

Down

keepalive reply received, No Error

Success

Up

(If no other condition prevents)

hello-time

Syntax

hello-time seconds

no hello-time

Context

config>service>sdp>keep-alive

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the time period between SDP keepalive messages on the SDP-ID for the SDP connectivity monitoring messages.

The no form of this command reverts the hello-time seconds value to the default.

Default

hello-time 10

Parameters

seconds

Specifies the time in seconds between SDP keepalive messages, expressed as a decimal integer.

Values

1 to 3600

hold-down-time

Syntax

hold-down-time seconds

no hold-down-time

Context

config>service>sdp>keep-alive

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the minimum time period the SDP remains in the operationally down state in response to SDP keepalive monitoring.

This parameter can be used to prevent the SDP operational state from ‟flapping” by rapidly transitioning between the operationally up and operationally down states based on keepalive messages.

When an SDP keepalive response is received that indicates an error condition or the max-drop-count keepalive messages receive no reply, the sdp-id is immediately brought operationally down. If a keepalive response is received that indicates the error has cleared, the sdp-id is eligible to be put into the operationally up state only after the hold-down-time interval has expired.

The no form of this command reverts to the default value.

Default

hold-down-time 10

Parameters

seconds

Specifies the time in seconds, expressed as a decimal integer, the sdp-id remains in the operationally down state before it is eligible to enter the operationally up state. A value of 0 indicates that no hold-down-time is enforced for sdp-id.

Values

0 to 3600

max-drop-count

Syntax

max-drop-count count

no max-drop-count

Context

config>service>sdp>keep-alive

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the number of consecutive SDP keepalive failed request attempts or remote replies that can be missed after which the SDP is take operationally down. If the max-drop-count consecutive keepalive request messages cannot be sent or no replies are received, the SDP-ID is taken operationally down by the keepalive SDP monitoring.

The no form of this command reverts to the default value.

Default

max-drop-count 3

Parameters

count

Specifies he number of consecutive SDP keepalive requests that are failed to be sent or replies missed, expressed as a decimal integer.

Values

1 to 5

message-length

Syntax

message-length octets

no message-length

Context

config>service>sdp>keep-alive

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the SDP monitoring keepalive request message length that is transmitted.

The message length should be equal to the SDP operating path MTU, as configured in the path-mtu command. If the default size is overridden, the actual size used is the smaller of the operational SDP-ID Path MTU and the size specified.

The no form of this command reverts the default value.

Default

message-length 0

Parameters

octets

Specifies the size of the keepalive request messages in octets, expressed as a decimal integer. The size keyword overrides the default keepalive message size.

Values

40 to 9198

timeout

Syntax

timeout timeout

no timeout

Context

config>service>sdp>keep-alive

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the time interval that the SDP waits before tearing down the session.

Default

timeout 5

Parameters

timeout

Specifies the timeout time, in seconds.

Values

1 to 10

1 This condition should not occur.