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

Executing CoA and Disconnect Requests Using Web GUI

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

Because the make and model of NADs 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 NADs in your network, you need to define supporting actions in the deviceModels.xml file for each NAD in your network, and specify the appropriate attribute packing list for each NAD 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 page in Web GUI. 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 NADs in your network. Naming actions consistently enables you to simply invoke the action without regard for which NAD 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 106.

Table 106: 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 NAD devices defined in your deviceModels.xml file.

To disconnect sessions using the Web GUI:

  1. Find the sessions that meet your search criteria. (See Searching for Sessions Using Web GUI .)
  2. In the Current Sessions page (Figure 253), select one or more sessions.

    To select more than one session, hold down the Ctrl key and click on the sessions.

  3. Select Device Action > Disconnect.

    A Disconnect dialog box appears (Figure 255).

    Figure 255: Example Disconnect Dialog

    Example Disconnect
Dialog
  4. In the Request Parameters area, leave the Acct-Session-Id check box cleared and leave the area as (using session data). The example shown in Figure 255 does not show the information for the Request Parameters area.

    This area of the dialog box 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 256).

    Figure 256: Example Result Dialog

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

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

    Figure 257: Example Session Data Dialog

    Example Session
Data Dialog
  7. Select the device in the Per-Device Detail area and click View.

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

  8. Click Close for each open dialog box.

Modified: 2017-09-27