Home
MATRIXX Subscriber Management
Managing Devices
You can create, provision, and delete devices by calling the SubMan APIs and scheduling automated tasks.
Delete Sessions
The delete_sessions.py script deletes sessions on one or more devices. Sessions can be identified by session type, device ID, and session ID. For information about using the SubMan APIs to delete sessions, see the discussion about device REST APIs in MATRIXX Subscriber Management API.
delete_sessions.py
The delete_sessions.py script deletes sessions on one or more devices.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
MATRIXX Pay Now
MATRIXX Subscriber Management
- About Subscriber Management
  MATRIXX Subscriber Management provides an overview of subscriber-related data, including users, groups, subscriptions, devices, balances, and notifications. You can capture any attribute of a subscription and base rating on it, enforce subscription and group spending limits across all services and networks, and notify users associated with subscriptions and groups when the subscriptions and groups are nearing spending limits.
- Subscriber Authorization
  Authorization is the process of verifying the subscriber's balance has the amount required to allow usage. MATRIXX Engine supports service authorization and cut-offs to ensure subscriber usage is valid and revenue loss does not occur.
- Subscription-User Association
  You can associate a subscription with a user in a many-many relationship using the user APIs.
- Subscription-Device Association
  When a network message is received, the device information is used to guide the service usage to the subscription. A subscription can have any number of associated devices.
- Managing Subscriptions
  Managing subscriptions includes adding subscriptions to groups, removing subscriptions from groups, setting the status of subscription objects, and associating users with subscriptions. You can perform these operations by using MATRIXX Backoffice Customer Tool and any custom applications that call the SubMan APIs.
- Managing Devices
  You can create, provision, and delete devices by calling the SubMan APIs and scheduling automated tasks.
  - Session Management
    During global configuration, you can configure session management parameters that control global session limits per device, interface-specific session limits per device, error messages, and session recycling.
  - Delete Sessions
    The delete_sessions.py script deletes sessions on one or more devices. Sessions can be identified by session type, device ID, and session ID. For information about using the SubMan APIs to delete sessions, see the discussion about device REST APIs in MATRIXX Subscriber Management API.
    - delete_sessions.py
      The delete_sessions.py script deletes sessions on one or more devices.
  - Validate Sessions
    The validate_sessions.py script validates sessions on one or more devices, or all the devices in the system. Sessions can be identified by session type (all, Gy, Sy, Gx, Rx). For information about using the SubMan APIs to validate sessions, see MATRIXX Subscriber Management API.
- Managing Users
  Managing users includes creating and deleting users, associating users with subscriptions, and assigning roles to users. You can perform these operations by using MATRIXX Backoffice Customer Tool and any custom applications that call the SubMan APIs.
- Managing Product Offers
  Managing product offers includes purchasing and canceling product offers, and removing expired product offers. You can purchase and cancel product offers by using MATRIXX Backoffice Customer Tool and any custom applications that call the SubMan APIs. Expired product offers are removed from _glossary/subscription.html and group wallets automatically after a configured amount of time.
- Managing Purchase Packages
  Use purchase packages to dynamically group catalog items and package them so they can be purchased as a single unit by a subscriber or group. Purchased items can be added to or removed from a purchase package through the purchase package APIs without requiring pricing changes, providing a single entity for promotional and business operations.
- Rehoming
  Rehoming is the process of moving a user, group, device, or subscription from one sub-domain to a different sub-domain in a multi-domain platform.
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

delete_sessions.py

The delete_sessions.py script deletes sessions on one or more devices.

If any error is received from a device, delete_sessions.py keeps running and writes unprocessed device IDs to the unprocessedDevices.txt file. For information about using the SubMan APIs to delete sessions, see MATRIXX Subscriber Management API.

Syntax

Important: The delete_sessions.py script must be run on a processing pod.

delete_sessions.py [options] deviceIdentifier_1 deviceIdentifier_2 deviceIdentifier_n

delete_sessions.py [options] -f inFile

Note: You must specify a list of device identifiers or a device input file. You cannot specify both.

Options

-h, --help

Displays help information for this script.

-H URI, --host URI

Specifies the URI Engine to which to connect. The default is localhost:4060.

-s sessionType, --session=sessionType

Specifies the type of sessions to validate. The sessionType options are:

All (default)
Gy
Sy
Gx
Rx
Tcap
Sh

-y sessionIdList, --sessions=sessionIdList

Specifies a comma-separated list of session ids to delete.

-f inFile, --file=inFile

Specifies the name of an input file of device identifiers. The file should list one id per line. Lines commented out with a # symbol are ignored. For example:

device_ids.txt:

408-123-4567
650-123-4567

-t queryType, --type=queryType

Specifies the device identifier type:

ObjectId (default)
ExternalId
Imsi
AccessNumber
LoginId
AccessId

This is applicable only if device ids are specified as arguments or are included in the input file.

-v, --verbose

Prints verbose processing information.

--throttle=maxDevices

Specifies the maximum number of devices to process per second. The default is 100.

--batch=batchSize

Specifies the number of devices to process per SubMan API call. The default is 20.

Delete Gx Sessions

delete_sessions.py -s Gx -f /inputFiles/device_ids.txt -t AccessNumber -v

Delete Sy Sessions 0:1:5:3 and 0:1:5:5

delete_sessions.py -s Sy 0:1:5:3 0:1:5:5