pem sessiondb
pem sessiondb(1) BIG-IP TMSH Manual pem sessiondb(1)
NAME
sessiondb - Displays, deletes, modifies, and reset-stats a PEM subscriber session record on the BIG-IP(r) system.
MODULE
pem
DESCRIPTION
You can use the sessiondb component to display session record on the BIG-IP system. Additionally, you can delete, reset-
stats and modify a specified session record. The subscriber-id or session-ip or all and/or the filtering arguments can be
specified as the query key. session-state must be specified in modify command.
When specifying an IP address in show/delete/modify/reset-stats sessiondb session-ip commands, the route domain ID may be
optionally included. The route domain ID follows the IP address and is separated by '%'. For example, 10.10.10.100%5 is an
IP address in route domain 5.
Note: show and reset-stats commands apply to both static and dynamic subscribers. Delete and modify commands only apply to
dynamic subscribers. The session of static subscribers cannot be deleted. The session-state of static subscribers cannot be
changed. To delete a static subscriber session you have to delete the static subscriber configuration in pem subscriber.
SHOW command
SYNTAX
show sessiondb subscriber-id []
show sessiondb session-ip /[] []
show all
options:
all-properties
field-fmt
DESCRIPTION
Used to display the session information.
subscriber-id can either be the complete subscriber-id or a wildcard.
session-ip be either the complete IP address, or a subnet, by specifying the prefix.
all is used to display all the sessions. Due to existing limitations, some of the arguments cannot be used with the 'all'
option. In this case, 'subscriber-id *' can be used.
all-properties options enables the per-IP traffic statistics in case of sessions with multiple IP addresses.
field-fmt option provides a structured output. This option is used for REST API compatibility.
args is an optional list of arguments, which can contain the following-
- filtering arguments: These specify the criteria for selecting sessions to display. The filtering arguments can be one or
more of the following
. imsi
. imeisv
. calling-station-id
. called-station-id
. user-name
. session-origin
. session-state
. device-name
. device-os
. user-location-info
This can either be the user location as a hex string, or the location info broken down into individual fields as
name value pairs. The values can be combined using '&' or '|' and can have only one of the operators, not both.
The key value pairs allowed are as follows ( 'D' stands for a decimal value and 'H' for hex digit) -
- type=[CGI | SAI | RAI | TAI | TAI+ECGI] - mcc=DD[D] - mnc=DD[D] - lac=[0x]HHHH - ci=[0x]HHHH -
sac=[0x]HHHH - rac=[0x]HHHH - tac=[0x]HHHH - eci=[0x]HHHHHHH
For e.g.
user-location-info 0x1234567 user-location-info type=CGI&mcc=123 user-location-info
type=TAI+ECGI|mcc=123|lac=0x3f5d
This is not allowed -
user-location-info type=CGI&mcc=123|mcc=456
. attr
This is the list of custom attribute key-value pairs. Multiple attributes can be combined with either '&' or '|'.
(cannot have a mix of '&' and '|' operators). There can be a maximum of 30 custom attributes.
. policy
List of policy names. This can again be combined using the '&' or '|' operators. There can be maximum of 30
policies.
. blade
. tmm
- include-deleted: This specifies whether to include sessions marked for deletion in the output.
- view-mode: This specifies the format of the output and can be one of extended, table or count. The extended view mode is
the default and gives a formatted output of all the session attributes and flow statistics. In the table mode, the user can
select the information to be displayed by selecting the list of columns. In this mode, the 'columns' argument HAS to be
specified containing the list of columns to display. Column names should be separated by ':' and should be from the
following list -
. subscriber_id
. tmm_number
. blade_number
. session_state_str
. session_origin_str
. ppe_session_id
. qpe_session_id
. imsi
. imeisv
. called_station_id
. calling_station_id
. user_name
. device_name
. device_os
. tower_id
. ip_info.ip_address
. policy_info.policy_name
. any custom attribute e.g. _sys_attr_3gpp_rat_type.
Any unknown column name is considered to be a custom attribute name.
If the view-mode is set to count, then only a count of the number of sessions matching the specified criteria is
displayed.
- max-count: This is used to specify an upper limit on the number of matching sessions to be considered for the command.
- resume-from: This argument is used to get a page-by-page listing of the sessions, and can be used only with the field-fmt
option.
DELETE command
SYNTAX
delete sessiondb subscriber-id []
delete session-ip [ip address>/[] []
delete all
DESCRIPTION
Used to delete sessions.
The optional arguments here can specify the filtering arguments, as explained in the show command above.
All the sessions matching the criteria are deleted.
MODIFY command
SYNTAX
modify sessiondb subscriber-id [] session-state [marked-for-deletion | not-provisioned | provisioned |
provisioning-pending ]
modify session-ip [ip address>/[] [] session-state [marked-for-deletion | not-provisioned | provisioned |
provisioning-pending ]
DESCRIPTION
Used to modify the session state.
The optional arguments here can specify the filtering arguments, as explained in the show command above.
The state of all the matching sessions are modified to the value specified.
session-state
Specifies the new subscriber session state.
The options are:
marked-for-deletion
Specifies that the subscriber session should be scheduled for deletion.
provisioned
Specifies that the subscriber session state should be marked as provisioned, regardless of whether the policies have
been assigned or not. The unknown subscriber policies are not applied to the subscriber flows, even if no subscriber
policies are provisioned.
not-provisioned
Specifies that the subscriber session state should be marked as not-provisioned. No further attempts to provision the
session are made. The unknown subscriber policies are applied to the subscriber flows.
provisioning-pending
Specifies that the subscriber session state should be marked as being in the process of provisioning. This will
trigger a session provisioning request (e.g. Gy CCR request) immediately. If no response is received, or the
provisioning process fails for any reason, another request will be sent after the retry timeout, until the session is
provisioned successfully, or the number of retries is reached.
RESET-STATS command
SYNTAX
reset-stats sessiondb subscriber-id []
reset-stats session-ip [ip address>/[] []
reset-stats all
DESCRIPTION
Used to reset the session statistics.
The optional arguments here can specify the filtering arguments, as explained in the show command above.
The statistics for all the sessions matching the criteria are reset.
EXAMPLES
show sessiondb subscriber-id 4085551212
Displays the session record of subscriber id 4085551212.
show sessiondb subscriber-id 408*
Displays the session record of all subscribers with id beginning with '408'.
show sessiondb subscriber-id *
Displays the session records of all subscribers.
show sessiondb session-ip 10.10.10.100
Displays the session record of session ip address 10.10.10.100.
show sessiondb session-ip 10.10.10.100%5
Displays the session record of session ip address 10.10.10.100 in route domain 5.
show sessiondb session-ip 10.10.10.10/24
Displays the session records of session ip addresses in the 10.10.10.0 subnet.
show sessiondb subscriber-id 4085551212 all-properties
Displays the session record of subscriber id 4085551212, and statistics for each IP.
show sessiondb session-ip 10.10.10.100 all-properties
Displays the session record of session ip address 10.10.10.100, and statistics for each IP.
show sessiondb session-ip 10.10.10.10/24 view-mode count
Displays the count of the number of session records with session ip address in the 10.10.10.0 subnet.
show sessiondb subscriber-id 408* session-state provisioned
Displays the count of the number of sessions whose id begins with '408' and are in the provisioned state.
delete sessiondb subscriber-id 4085551212
Deletes the session record of subscriber id 4085551212.
delete sessiondb session-ip 10.10.10.100
Deletes the session record of IP address 10.10.10.100.
delete sessiondb session-ip 10.10.10.100%5
Deletes the session record of IP address 10.10.10.100 in route domain 5.
delete sessiondb session-ip session-state provisioning-pending
Deletes all sessions that are in the provision pending state.
reset-stats sessiondb subscriber-id 4085551212
Reset the session statistics of subscriber id 4085551212. Flows Current specifies the active flows and it cannot be
reset.
modify sessiondb subscriber-id 4085551212 session-state provisioned
Modifies the session state of subscriber id 4085551212 to provisioned.
modify sessiondb subscriber-id 408* session-state provisioned
Modifies the session state of sessions with subscriber id starting with 408 to state provisioned.
SEE ALSO
delete, modify, reset-stats, show, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or by any means, electronic or mechanical, including
photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchaser's personal
use, without the express written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2009-2014, 2016. All rights reserved.
BIG-IP 2016-03-14 pem sessiondb(1)