Steel-Belted Radius Carrier 7.2.x Administration and Configuration Guide > Using SBR Administrator to Manage and Control Sessions > Executing CoA and Disconnect Requests Using SBR Administrator

Executing CoA and Disconnect Requests Using SBR Administrator

NOTE: CoA/DM support is only available with the optional Session Control license.

Because the make and model of NAS devices differ in each network environment, the default actions defined in the deviceModels.xml file for Change of Authorization (CoA) and Disconnect Message (DM) requests are for example purposes only. To issue CoA or DM (action) requests to NAS devices in your network, you need to define supporting actions in the deviceModels.xml file for each NAS in your network, and specify the appropriate attribute packing list for each NAS make and model.

After an action is defined in the deviceModels.xml file, a button labeled with the name of the action becomes available in the Current Sessions panel of SBR Administrator. To execute the action, you simply perform a query to locate and select one or more sessions, and then select the action button to execute the action.

When configuring actions in the deviceModels.xml file, be consistent about what you name the actions for the various makes and models of NAS devices in your network. Naming actions consistently enables you to simply invoke the action without regard for which NAS is handling the session you want to take action on.

Example of Executing a Disconnect Action

NOTE: The procedure in this section is an example only, and assumes you have already created the action titled Disconnect in the deviceModels.xml file.

After you have found a list of sessions matching the criteria you specify, you can select one or more of the sessions to disconnect. The effect of disconnecting sessions on the current session table (CST) is described in Table 108.

Table 108: Effect on CST of Disconnecting Sessions  

Action	Result	Effect on Current Session Table
Request to disconnect is sent and the disconnect is acknowledged (ACK)	Controlled device sends a RADIUS Accounting-Request (Stop) to the accounting client, which, in turn, sends a Stop to the SBR Carrier.	Session is deleted from the CST
Request to disconnect is sent and the disconnect is not acknowledged (NAK)	Not applicable	Session is deleted from the CST because the session does not exist
Request to disconnect is sent and the disconnect times out	Not applicable	No effect on the CST

NOTE: The procedure in this section is an example only. The exact fields that are displayed change depending on the actions and the make and model of the NAS devices defined in your deviceModels.xml file.

To disconnect sessions:

1. Find the sessions that meet the criteria you specify. (See Searching for Sessions Using SBR Administrator591.)
2. In the Total Sessions list, select one or more sessions (Figure 202).

To select more than one session, hold down the ctrl key and click on the sessions. To select all sessions, press ctrl+a.

Figure 204: Selection of Sessions to Be Disconnected

3. Click Disconnect.

A Disconnect dialog opens (Figure 205).

Figure 205: Example Disconnect Dialog

4. In the Request Parameters field, leave the Acct-Session-Id checkbox unchecked and leave the field as (using session data). The example shown in Figure 205 does not show the information for the Request Parameters field.

This area of the dialog indicates that the session identifiers are taken from the sessions you selected.

5. Click Disconnect.

A watch icon appears while the disconnect request is processed. One or more of the result tabs becomes active (Successes, Failures, Timeouts, Errors), depending on the result of the disconnect attempt (Figure 206).

Figure 206: Example Result Dialog

6. Select an active result tab and a session, and click View.

A Session Data dialog opens (Figure 207). The Session Data dialog has a different appearance for different device makes and models. The attributes that appear in the Session Data dialog vary depending on the make and model of the device. Different devices send different attribute packing lists and values.

Figure 207: Example Session Data Dialog

7. Select the device in the Device box and click View.

Information from the device running the session you disconnected (or attempted to disconnect) is displayed

8. Click Close for each open window.