Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

terminate-code

 

Syntax

Hierarchy Level

Release Information

Statement introduced in Junos OS Release 11.4.

vlan option added in Junos OS Release 16.1.

Description

Customize the mapping between a termination cause (the internal termination identifier) and a numerical code value for the cause that is reported in the RADIUS Acct-Terminate-Cause attribute (49).

When a RADIUS Acct-Stop message is issued as a result of the termination of a subscriber or service session, the RADIUS Acct-Terminate-Cause attribute (49) reports the cause or reason for the termination. This attribute is included only in RADIUS Acct-Stop messages. The termination cause is conveyed as a code value in the attribute. RFC 2866, RADIUS Accounting, defines the standard mapping between 18 code values and termination causes.

Junos OS defines a set of internal termination cause codes for AAA, DHCP, L2TP, PPP, and VLAN subscriber and service session failures. By default, these internal cause codes are mapped to the RFC-defined code values. When a subscriber or service session is terminated, the router logs a message for the internal termination cause and logs another message for the RADIUS Acct-Terminate-Cause attribute. You can use the logged information to help monitor and troubleshoot the events.

Because there are many different Junos OS internal identifiers for termination causes and only 18 supported, RFC-defined standard code values, by default a given code value can map to multiple identifiers. Instead of using the default code values, you can use the terminate-code statement to map any of the internally defined termination causes to any 32-bit number (1 through 4,294,967,295). The flexibility of customized mapping greatly increases the possibilities for fine-grained analytics and failure tracking.

Options

aaaMap internal identifiers for AAA-specific termination causes to a numerical value.
denyLimit selection of termination causes to those associated with denial of subscriber access.
dhcpMap internal identifiers for DHCP-specific termination causes to a numerical value.
l2tpMap internal identifiers for L2TP-specific termination causes to a numerical value.
pppMap internal identifiers for PPP-specific termination causes to a numerical value.
radius valueNumber that represents the termination cause in the RADIUS Acct-Terminate-Cause attribute (49).

Range: 1 through 4,294,967,295

service-shutdownLimit selection of termination causes to those associated with established service sessions independent of the parent subscriber session.
shutdownLimit selection of termination causes to those associated with established subscriber sessions.
vlanMap internal identifiers for VLAN-specific termination causes to a numerical value.
term-reasonInternal identifier for the termination causes defined for the specified protocol type.

For protocol-specific termination causes, see the following topics:

Required Privilege Level

routing—To view this statement in the configuration.

routing-control—To add this statement to the configuration.