Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation  Back up to About Overview 
  
[+] Expand All
[-] Collapse All

Examples of Issuing CoA/DM Requests Using the Command Line Utility

Query Example Using Wildcard

Query for sessions running on controlled devices with identifiers beginning with the letter L. Return up to 10 sessions.

$ SessionControl.sh -authuser my_user -authpass my_password -s my_server_name -p 1814 -rootca /opt/JNPRsbr/radius/root/autoGeneratedRoot.cer -m query -a User-Name -v "L*" -sl 10 -force

Disconnect Example

Disconnect the session that has a session ID of 1234.

$ SessionControl.sh -authuser my_user -authpass my_password -s my_server_name -p 1814 -rootca /opt/JNPRsbr/radius/root/autoGeneratedRoot.cer -m disconnect -a Acct-Session-Id -v 1234

Note: Acct-Session-Id is a required attribute to execute a disconnect. This attribute is commonly used in CoA/DM packing lists for router requirements. Packing lists represent the router’s requirements for a valid DM or CoA request. Attributes that are not in the Current Sessions Table (CST) must come from the actual query to fulfill the request.
To have data available for queries using the command line client, you must configure this attribute in the packing list. If the Sbr_AcctSession-Id does not exist in the CST or is not found by the query itself, the request fails.

For details on customizing the CST, see the SBR Carrier Installation Guide.

Note: The CoA/DM requests require the SCM license.

Lawful Intercept Example

Intercept the session with the accounting session ID of 12345 and send log information about the session to the specified device.

$ SessionControl.sh -authuser my_user -authpass my_password -s my_server_name -p 1814 -rootca /opt/JNPRsbr/radius/root/autoGeneratedRoot.cer -m interceptOn-a Acct-Session-Id -v 12345-a Lawful-Intercept-Action -v 1-a Lawful-Intercept-Identifier 2468-a Lawful-Intercept-Mediation-Device-Port-Number -v 4567-a Lawful-Intercept-Mediation-Device-Port-IP-Address-v 123.45.6.78

Note: The attributes needed to execute a lawful intercept are unique to the make and model of the controlled device. Some devices may require the entire word LegalIntercept as part of its configuration, and some devices may only use the abbreviation LI for their configuration. See the technical documentation of the device for a list of attributes required to execute a lawful intercept or other type of request.

Modified: 2017-03-07