Session Parameters Commands

session-parameters

Syntax

session-parameters

Context

config>router>ldp

Description

This command enables the context to configure peer-specific parameters.

peer

Syntax

[no] peer ip-address

Context

config>router>ldp>session-params

Description

This command configures parameters for an LDP peer.

Default

n/a

Parameters

ip-address

specifies the LDP peer in dotted-decimal notation

export-addresses

Syntax

export-addresses policy-name [policy-name...(up to 5 max)]

no export-addresses

Context

config>router>ldp>session-params>peer

Description

This command specifies the export prefix policy to local addresses advertised to this peer.

Policies are configured in the config>router>policy-options context. A maximum of five policy names can be specified.

The no form of the command removes the policy from the configuration.

Default

no export-addresses

Parameters

policy-name

the name of an existing export prefix route policy

export-prefixes

Syntax

export-prefixes policy-name [policy-name...(up to 5 max)]

no export-prefixes

Context

config>router>ldp>session-params>peer

Description

This command specifies the export route policy used to determine which prefixes received from other LDP peers are redistributed to this LDP via the LDP session to this peer. Any prefix that has been accepted in the route policy will be exported. Any prefix that has been filtered out of the route policy will not be exported.

Policies are configured in the config>router>policy-options context. A maximum of five policy names can be specified. The peer address must be the peer LSR ID.

If no export policy is specified, all FEC prefixes learned will be exported to this LDP peer. This policy is applied in addition to the global LDP export policy and targeted sessions.

The no form of the command removes the policy from the configuration.

Default

no export-prefixes

Parameters

policy-name

the name of an existing export policy

fec-type-capability

Syntax

fec-type-capability

Context

config>router>ldp>if-params>if>ipv4

config>router>ldp>if-params>if>ipv6

config>router>ldp>session-params>peer

Description

This command enables or disables the advertisement of a FEC type for a specified LDP session or Hello adjacency to a peer.

Default

n/a

p2mp

Syntax

p2mp {enable | disable}

Context

config>router>ldp>session-params>peer>fec-type-capability

Description

This command enables or disables P2MP FEC capability for the session.

Default

p2mp disable

Parameters

enable | disable

enables or disables P2MP FEC capability

prefix-ipv4

Syntax

prefix-ipv4 {enable | disable}

Context

config>router>ldp>if-params>if>ipv4>fec-type-capability

config>router>ldp>if-params>if>ipv6>fec-type-capability

config>router>ldp>session-params>peer>fec-type-capability

Description

This command enables or disables IPv4 prefix FEC capability on the session or interface.

Default

prefix-ipv4 disable

Parameters

enable | disable

enables or disables IPv4 prefix FEC capability

prefix-ipv6

Syntax

prefix-ipv6 {enable | disable}

Context

config>router>ldp>if-params>if>ipv4

config>router>ldp>if-params>if>ipv6

config>router>ldp>session-params>peer>fec-type-capability

Description

This command enables or disables IPv6 prefix FEC capability on the session or interface.

Default

prefix-ipv6 disable

Parameters

enable | disable

enables or disables IPv6 prefix FEC capability

tcp-session-parameters

Syntax

tcp-session-parameters

Context

config>router>ldp

Description

This command enables the context to configure parameters for the TCP transport session of an LDP session to a remote peer.

Default

n/a

peer-transport

Syntax

[no] peer-transport ip-address

Context

config>router>ldp>tcp-session-parameters

Description

This command configures the peer transport address, which is the IPv4 or IPv6 destination address of the TCP connection to the LDP peer.

Default

n/a

Parameters

ip-address

the IPv4 or IPv6 address of the TCP connection to the LDP peer in dotted-decimal notation

auth-keychain

Syntax

auth-keychain name

no auth-keychain

Context

config>router>ldp>tcp-session-params>peer-transport

Description

This command associates an authentication keychain with LDP. The keychain is a collection of keys used to authenticate LDP messages from remote peers. The keychain allows the rollover of authentication keys during the lifetime of a session and also supports stronger authentication algorithms than clear text and MD5.

The keychain must already be defined in the config>system>security>keychain context.

Either the authentication-key command or the auth-keychain command can be used by LDP, but both cannot be supported at the same time. If both commands are configured, the auth-keychain configuration is applied and the authentication-key command is ignored.

By default, authentication is not enabled.

Default

no auth-keychain

Parameters

name

the name of an existing keychain, up to 32 characters

authentication-key

Syntax

authentication-key {authentication-key|hash-key}[hash | hash2]

no authentication-key

Context

config>router>ldp>tcp-session-params>peer-transport

Description

This command specifies the authentication key to be used between LDP peers before establishing sessions. Authentication uses the MD5 message-based digest.

Either the authentication-key command or the auth-keychain command can be used by LDP, but both cannot be supported at the same time. If both commands are configured, the auth-keychain configuration is applied and the authentication-key command is ignored.

The no form of this command disables authentication.

Default

n/a

Parameters

authentication-key

specifies the authentication key. Allowed values are any string up to 16 characters long (unencrypted) composed of printable, 7-bit ASCII characters. If the string contains special characters (such as #, $, spaces), the entire string must be enclosed within double quotes.

hash-key

specifies the hash key. Allowed values are any string up to 33 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (such as #, $, spaces), the entire string must be enclosed within double quotes.

This is useful when a user must configure the parameter; however, for security purposes, the actual unencrypted key value is not provided.

hash

specifies that the key is entered and stored on the node in encrypted form

hash2

specifies that the key is entered and stored on the node in a more complex encrypted form

Note:

If neither the hash or hash2 keyword is specified, the key is entered in clear text. However, for security purposes, the key is stored on the node using hash encryption.