terminate-code
Syntax
terminate-code (aaa (deny | service-shutdown | shutdown) | dhcp | l2tp | ppp | vlan) term-reason radius value;
Hierarchy Level
[edit access]
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
| aaa | Map internal identifiers for AAA-specific termination causes to a numerical value. |
| deny | Limit selection of termination causes to those associated with denial of subscriber access. |
| dhcp | Map internal identifiers for DHCP-specific termination causes to a numerical value. |
| l2tp | Map internal identifiers for L2TP-specific termination causes to a numerical value. |
| ppp | Map internal identifiers for PPP-specific termination causes to a numerical value. |
| radius value | Number that represents the termination cause in the RADIUS Acct-Terminate-Cause attribute (49).
|
| service-shutdown | Limit selection of termination causes to those associated with established service sessions independent of the parent subscriber session. |
| shutdown | Limit selection of termination causes to those associated with established subscriber sessions. |
| vlan | Map internal identifiers for VLAN-specific termination causes to a numerical value. |
| term-reason | Internal 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.
Release Information
Statement introduced in Junos OS Release 11.4.
vlan option added in Junos OS Release 16.1.